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COURSE DESCRIPTION 
Multics Concepts and Utilization 


Five Days 


Personnel requiring capability to use the Multics 
System. 


This course presents the basic information needed 
to use the Multics system, including discussions 
and examples of: the typing conventions used for 


“Multics terminals; a Multics text editor; 


commands used to write, compile and execute 


programs; utility command which provide of the 


user environment, manipulation of files, and 


inter-user communication; and the types of errors 
which can occur, with procedures for.recovery. A 


general overview of Multics hardware and software 


facilities is also presented. 


Interactive workshops are included to reinforce 
the material presented. 


Upon completion of this course, the student should 
be able to: 


1. Login to and logout from the Multics system. 


2. Create and edit files in the storage system 
with the qedx text editor. 


—— 


3. Compile, run, and debug simple programs, and 
Manipulate the run-time environment.» 


4. Use other system commands to manipulate files, 
' tailor the user environment, and communicate 
with other users. 


Programming Logic and Flowcharting (GO024) or 
previous data processing experience. 
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STUDENT BACKGROUND 


Multics Concepts and Utilization (F01) 


NAME: PHONE: 
TITLE: | 


COMPANY ADDRESS: 


MANAGER: OFFICE PHONE: 
INSTRUCTOR'S NAME: [Zhen y Li dal 


Do you meet the prerequisite as stated in the "Course Description" 
of the student text? If yes, check "a" or "b", 
If no, check "c" or "d", 


a { ] Prerequisite satisfied by attending course indicated in 
"Course Description". | 


b [ ] Meet prerequisite by equivalent experience (explain briefly) 


ce [ ] Elected or instructed to attend course anyway. 


d { ] Was not aware of prerequisite. 


What related Honeywell courses have you attended? Furnish dates 
and instructors if possible. 


(PLEASE TURN OVER) 
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STUDENT BACKGROUND 


Check the boxes for which you have any related experience. (May 
be other than Honeywell's) 


] 


] 
] 


PL1 [ ] COBOL [ ] FORTRAN [ ] ASSEMBLY 
JCL [ ] OPERATIONS [ ] Gcos [ ] MULTICS 
OTHER COMPUTER RELATED 


Detail any Multics experience you have had: 


Objectives for attending this course (May check more than one). 


Or i ai a a See, 


] 
] 
] 
] 


Require information to provide support for a Multics system 
To maintain an awareness of this product 

To evaluate or compare ies potentials 

Required to use or implement 

Need update from a previous release 

Require a refresher 


Other: 


TOPIC I 


MULTICS OVERVIEW 


Page 
Some Basic Terminology be ee: we. Ge ke Bo ht ae, ST 
Development History . . ic ee oe. SE hae Gey ey te es Set ee, 
Multics Design Goals and Results: | 1-9 
Administration . : ‘ ; 1-15 
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SOME BASIC TERMINOLOGY 


@® HARDWARE 


] REFERS TO THE PHYSICAL COMPONENTS OF A COMPUTER; ESPECIALLY TO 
THE ELECTRONIC CIRCUITRY 


1 MAJOR COMPONENTS: CENTRAL PROCESSOR UNIT (CPU), MAIN MEMORY, 
- . DISK DRIVES, TAPE UNITS, PRINTER, CARD READER, CARD PUNCH 


® SOFTWARE 


J REFERS TO THE PROGRAMS, PROCEDURE, CODE, OR INSTRUCTIONS THAT 
EXECUTE ON THE HARDWARE 


1 EXAMPLES: A FORTRAN PROGRAM, THE PL/I COMPILER, THE DATA BASE 
MANAGER, THE OPERATING SYSTEM 
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SOME BASIC TERMINOLOGY 


SYSTEM RESOURCES 
1 CENTRAL PROCESSOR / CPU (TIME OCCUPIED) 


1 MAIN MEMORY / PRIMARY MEMORY / CORE (AMOUNT OCCUPIED * TIME 
OCCUPIED) 


1 PERIPHERAL DEVICES 
1 ‘DISK DRIVES (AMOUNT OF DATA TRANSFERRED) 
1 TAPE DRIVES (AMOUNT OF DATA TRANSFERRED) 
1 CARD PUNCH (AMOUNT OF DATA PUNCHED) 
1 PRINTER (AMOUNT OF DATA PRINTED) 


1 TERMINALS (CONNECT TIME & AMOUNT OF DATA TRANSFERRED) 


) MEDIA 


1 DISK PACKS / SECONDARY MEMORY (AMOUNT OF DATA STORED) 
) TAPES (NUMBER USED) 
] CARDS (NUMBER PUNCHED) 


1 PRINTER PAPER (AMOUNT USED) 


f SYSTEM AND SITE PROVIDED SOFTWARE (RENTAL) 
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SOME BASIC TERMINOLOGY 


BIT 
] THE MOST FUNDAMENTAL UNIT OF INFORMATION 


1 A BIT IS EITHER ON OR OFF (1 OR 0) 


BYTE 


1 A SMALL UNIT FOR MEASURING THE AMOUNT OF MEMORY, THE SIZE OF A 
PROGRAM OR FILE, OR THE SPACE ON A TAPE OR DISK PACK 


1 ON MOST LARGE SCALE HONEYWELL EQUIPMENT, A BYTE EQUALS 9 BITS 


a 
mend 


1 ON MULTICS, ONE ASCII CHARACTER OCCUPIES ONE BYTE 


WORD 


1 A LARGER UNIT FOR MEASURING THE AMOUNT OF MEMORY, THE SIZE OF A 
PROGRAM OR FILE, OR THE SPACE ON A TAPE OR DISK PACK 


J ON MOST LARGE SCALE HONEYWELL EQUIPMENT, A WORD EQUALS 4 BYTES 
OR 36 BITS ee ee 


—— 
nt 


es [yo ALL 


Mur’ 
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SOME BASIC TERMINOLOGY 


@ USER 


l ONE WHO USES THE COMPUTER FACILITY 


@ PROJECT 


I 


A SET OF USERS GROUPED TOGETHER FOR ACCOUNTING AND ACUcSS 
PURPOSES 


A PROJECT IS. OFTEN A GROUP OF USERS WORKING TOWARDS A COMMON 
GOAL © . 


USERS ON A PROJECT OFTEN WORK FOR THE SAME DEPARTMENT OR UNIT 


DEVELOPMENT HISTORY 


MULTICS 


] MULTIPLEXED INF ORMATION AND COMPUTING SERVICE 


1960-1963: CTSS DEVELOPMENT 
] FIRST LARGE-SCALE TIME-SHARING SYSTEM 
l EXPERIENCED GAINED WAS USED LATER IN THE MULTICS PROJECT 


I cTSS WAS USED TO DEVELOP MULTICS SOFTWARE 


1964: INITIAL SPECIFICATIONS FOR MULTICS 
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DEVELOPMENT HISTORY 


® 1964-1965: INITIAL MULTICS DEVELOPMENT WAS A JOINT EFFORT BY: 


1 MASSACHUSETTS INSTITUTE OF TECHNOLOGY (PROJECT MAC) 
J OVERALL PROJECT CO-ORDINATION 


1 OPERATING SYSTEM 


1 SELECTION AND DESIGN MODIFICATIONS OF THE HARDWARE (GE 63°); 


l BELL TELEPHONE LABORATORIES 
l COMPILERS AND ASSEMBLER 


] FILE SYSTEM 


] GENERAL ELECTRIC COMPUTER DIVISION (HONEYWELL) 


1 HARDWARE MODIFICATION 


@ 1965: FALL JOINT COMPUTER CONFERENCE 


] PRIMARY TECHNICAL PAPERS PRESENTED 
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DEVELOPMENT HISTORY 
1967: GE 645 HARDWARE AVAILABLE (MODIFIED GE 635) 
1967: SOFTWARE DEVELOPMENT UNDERWAY 
1968: AVAILABLE TO SYSTEM PROGRAMMERS 
1969: AVAILABLE FOR USE AT MIT 
1971: PROJECT MAC FUNDING STOPPED. HIS ADOPTS. 


1972: 6180 HARDWARE AVAILABLE 
1 BULK STORE REPLACED DRUM 
1 EXTENDED INSTRUCTION SET (EIS) 


1 RING MECHANISM MOVED TO HARDWARE 
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1973: 


1974: 


DEVELOPMENT HISTORY 


ANNOUNCED AS A "STANDARD" HIS PRODUCT 


LEVEL 68 HARDWARE 


1 68/60 MOS MEMORY 


1 68/80 MOS MEMORY AND CACHE STORE 


1975: 


1975: 


1976: 


1977: 


COBOL-74 


SORT/MERGE 


MULTICS DATA BASE MANAGER (MDBM) 


WORD PROCESSING SYSTEM (WORDPRO) 


EI? ARCS 0 CE 


MULTICS DESIGN GOALS AND RESULTS 


REMOTE TERMINAL ACCESS AS NORMAL USAGE MODE 


t= 


ALL SYSTEM RESOURCES AVAILABLE VIA TERMINALS 
l USAGE OF CARDS IS MINIMAL 
J INTERACTIVE AND BATCH ENVIRONMENTS ARE COMPATIBLE 


1 INTER-USER COMMUNICATION 


CONTINUOUS/UTILITY GRADE OPERATION 


1 EXTREMELY STABLE OPERATING SYSTEM 
1 MODULAR DESIGN 


1 WRITTEN IN PL/I 


0 ON LINE METERING, ACCOUNTING, BILLING AND SOFTWARE INSTALLATION 
1 OPERATORS REQUIRED: ONE 


] UNATTENDED OPERATION MODE 
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MULTICS DESIGN GOALS AND RESULTS 


@ ABILITY TO GROW AND CONTRACT WITHOUT SYSTEM OR USER REORGANIZATION 


1 SYSTEM SIZE - TRANSPARENT TO USERS, PROGRAMS, AND OPERATING 
SYSTEM 


] CHANGES TO SYSTEM SIZE ARE MADE WITHOUT REGENERATING THE 
OPERATING SYSTEM OR USER PROGRAMS 


] DYNAMIC RECONFIGURATION - TRANSPARENT TO USERS AND PROGRAMS 


@ DECENTRALIZATION OF THE SYSTEM'S ADMINISTRATION 


1 HIERARCHY OF ADMINISTRATORS: 
l THE SYSTEM ADMINISTRATOR 


q PROJECT ADMINISTRATORS 


1 USERS 


MULTICS DESIGN GOALS AND RESULTS 


a a 


@ DECENTRALIZATION OF THE SYSTEM'S LOGICAL FILE SPACE 


I HIERARCHY er ee 
] ROOT DIRECTORY 
1 SYSTEM pEneeronies 
1 PROJECT DIRECTORIES 


1 USER DIRECTORIES 


@ RELIABLE FILE SYSTEM 


q INCREMENTAL BACKUP SYSTEM (Backup SysDaemon) 
) AUTOMATED RETRIEVAL 


l SALVAGE SUBSYSTEM 
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MULTICS DESIGN GOALS AND RESULTS 


CEE 0 


ACCESS CONTROLS THAT ALLOW SELECTIVE SHARING OF INFORMATION AND 
SERVICES 


J MULTICS IS THE MOST SECURE COMMERCIAL OPERATING SYSTEM 
AVAILABLE | 


1 USER AUTHENTICATION (BY PASSWORD) 


l ACCESS CONTROL LIST - ACL (BY NAME AND PROJECT) 


c= 
[+= 
>) 


J RING STRUCTURE (8 LEVEL MASTER/SLAVE HIERARCHY) 


SERVES BOTH LARGE AND SMALL USERS EFFICIENTLY 


1 RESOURCES ARE AUTOMATICALLY ALLOCATED ON DEMAND - WHEN NEEDED, 
AND IN PROPORTION TO THE SIZE OF THE TASK 
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MULTICS DESIGN GOALS AND RESULTS 


iP RS | 


COMBINE SYSTEM FLEXIBILITY WITH EASE OF USE 

| VIRTUAL MEMORY 

] ONLY ONE STORAGE SYSTEM FOR BOTH USERS AND OPERATING SYSTEM 
I ASCII CHARACTER SET USED THROUGHOUT 

I] INTERACTIVE AND BATCH ENVIRONMENTS ARE COMPATIBLE 


EXEMPLARY COMMAND LANGUAGE (NO JCL!) 


1 COMMAND NAMES | 
1 FULL NAME (DESCRIPTIVE) 
1 SHORT NAME (CONVENIENT) 


1 CONTROL. ARGUMENTS WITH INTELLIGENT DEFAULTS 
(1 ACTIVE FUNCTIONS 


I] STAR AND EQUAL CONVENTION 


t= 
-) 
© 
= 
= 
ho 
az 
ww] 
be 
ra 
rm 
Fs) 
o> 
a] 
rH 
© 
= 


I] ABBREV PROCESSOR 


l EXEC_COMS (COMMAND FILES) 
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MULTICS DESIGN GOALS AND RESULTS — 


LM sae coe 


DIFFERENT ENVIRONMENTS AND HUMAN INTERFACES WITHIN A SINGLE SYSTEM 
1 STANDARD SERVICE (FULL MULTICS) 

1 SUBSYSTEM (E.G. FAST, BASIC, APL) 

1 LIMITED SERVICE 


1 TAILORED ENVIRONMENT 


EVOLUTIONARY DESIGN ABLE TO INCORPORATE TECHNOLOGICAL IMPROVEMENTS 
AND TO MEET GROWING USER EXPECTATIONS 


1 MODULAR DESIGN 
1 GENERAL (NOT SPECIFIC) SOLUTIONS 


1 COMPATIBLE EXPANSIONS 
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(1) 
(2) 


ADMINISTRATION 


THE EFFECTIVE ADMINISTRATION OF A LARGE COMPUTER INSTALLATION CAN 
BE A DIFFICULT JOB 


FOR MULTICS, A HIERARCHY OF ADMINISTRATORS HAS BEEN DEFINED IN 
ORDER TO: . | 


] DECENTRALIZE CONTROL OF SYSTEM RESOURCES BY DISTRIBUTING 
AUTHORITY AND RESPONSIBILITY TO LOWER LEVELS 


THE MULTICS ADMINISTRATION HIERARCHY CONSIST OF THREE LEVELS: 
1 SYSTEM ADMINISTRATOR(1) 
SYSTEM 


) PHYSICAL, ADMINISTRATIVE AND FINANCIAL CONCERNS OF THE 


] PROJECT ADMINISTRATOR(2) 


1 ADMINISTRATIVE AND FINANCIAL CONCERNS OF THE PROJECT 


J USER 


I CONTROL AND USAGE OF RESOURCES ALLOCATED TO HIM/HER 


Related Multics Course: System Administration (F60) 


Related Multics Course: Project Administration (F61) 
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ADMINISTRATION 


SYSTEM 
ADMINISTRATOR 


FO1 PROJECT 
ADMINISTRATOR 


ProjA PROJECT 
ADMINISTRATOR 


ADMINISTRATION 


THE SYSTEM ADMINISTRATOR 


2 ESTABLISHES SYSTEM CONFIGURATION AND OPERATING PARAMETERS 
(METERING AND TUNING) 


0 DEFINES, CREATES, AND ALLOCATES RESOURCES TO THE SYSTEM 
PROJECTS | 


J ADMINISTERS THE SYSTEM'S SECURITY NEEDS 

1 REGISTERS USERS AND ASSIGNS INITIAL (AND NEW) PASSWORDS 
l MAINTAINS RECORDS OF SYSTEM USAGE 

l SETS RESOURCE USAGE PRICES AND DETERMINES BILLING CYCLE 


] GENERATES STATEMENT OF CHARGES TO RECOVER THE COST OF SYSTEM 
RESOURCES USED 


1 PERFORMS ALL OF THE ABOVE TASKS FROM A TERMINAL AND WITHOUT 
INTERRUPTION OF SERVICE — 
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ADMINISTRATION 


THE PROJECT ADMINISTRATOR 

] DISTRIBUTES RESOURCES AND ATTRIBUTES ALLOCATED TO PROJECT 

J HAS ACCESS TO THE PROJECT'S RESOURCE USAGE AND ACCOUNTING DATA 
1 ADDS AND DELETES REGISTERED (AND ANONYMOUS) USERS TO paouees 

1 DEFINES THE ENVIRONMENT AND SETS RESOURCE LIMITS FOR USERS 


1 SETS ACCESS ON USERS' HOME DIRECTORY 


THE USER 

1 HAS CONTROL OVER RESOURCES ALLOCATED TO HIM 

l HAS ACCESS TO HIS OWN RESOURCE USAGE AND ACCOUNTING DATA 

] MAY eepmenuiert SHARE HIS PROGRAMS AND DATA WITH OTHER USERS 


1 MAY CHANGE HIS PASSWORD 


TOPIC II 


HOW TO ACCESS MULTICS 


Page 
Remote Terminal Access. eee ~ ea) 
User Registration and Identification of ies a ~ e-2 
Characteristics of Terminals ee, ne » 2-4 
Access Sequence . . i tee Se ele ‘ ~ 2-5 
login and logout Commands eA: Niet cage alse 2-6 
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Some Simple Commands .... 2-11 
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REMOTE reRMIWaL ACCESS 
REMOTE TERMINAL ACCESS IS THE NORMAL MODE OF ACCESS 
ALL SYSTEM RESOURCES ARE ACCESSIBLE VIA REMOTE TERMINAL 
USES STANDARD TELEPHONE LINES 


"LOGGING IN" REFERS TO THE PROCESS OF: 

l TEE ROUEN THE MULTICS SYSTEM 

1 CONNECTING THE TELEPHONE TO THE TERMINAL 

1 WAITING FOR MULTICS TO SEND YOU A GREETING 


1 IDENTIFYING YOURSELF TO THE SYSTEM 
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USER REGISTRATION AND IDENTIFICATION 


NEW USERS ARE REGISTERED BY THE SITE SYSTEM ADMINISTRATOR 


ADMINISTRATOR ASSIGNS A Project id, A UNIQUE Person id, AND A 
PASSWORD = 

Person id's Project id's -PASSWORD'S 

TSmith ProjA ts 

Greenberg ProjaA $$$! 


Student 04 FO1 atlanta 


A USER MAY BELONG TO MORE THAN ONE PROJECT - HOWEVER, ONE PROJECT 
IS ALWAYS DESIGNATED AS THE USER'S "DEFAULT PROJECT" 


THE USER'S PASSWORD IS ASSOCIATED WITH HIS Person_id ONLY 
User_id 
) REFERS TO THE Person_id.Project_id PAIR 


TSmith.ProjA 
SWebber.Doc 66 
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USER REGISTRATION AND IDENTIFICATION 


THE USER'S PASSWORD IS REQUIRED IN ORDER TO AUTHENTICATE THE USE 
OF THE USER'S Person id | 


THE USER'S Person_id AND Project_id ARE THE KEYS THAT DETERMINE 
WHAT INFORMATION AND SERVICES HE IS AUTHORIZED TO ACCESS AND 
CONTROL : 


1 Password 


AUTHORIZES 
USE OF 


-Person_id.Project_id 


AUTHORIZES 
USE OF 


DESIGNATED FILES 


AND SERVICES 
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CHARACTERISTICS OF TERMINALS 
TERMINALS BEHAVE LIKE ELECTRIC TYPEWRITERS 
MANY HAVE SEPARATE "CARRIAGE RETURN" AND "LINE FEED" KEYS 


CONCEPTUALLY, THE "LINE FEED" KEY SENDS THE TYPED LINE 


; — 
DUPLEX: HALF 6&&% MODE: LINE 
CASE: LOWER RATE: 30 
PARITY: EVEN 


TERMINAL TO COMPUTER COUPLINGS: 


1 HARDWIRED (A PERMANENT WIRE CONNECTS TERMINAL TO COMPUTER) 


1 TELEPHONE-MODEM (TELEPHONE LINE CONNECTS TERMINAL TO COMPUTER) 


J ACOUSTIC (PROXIMITY) 


] DIRECT (PUSH A BUTTON) 
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ACCESS SEQUENCE 
PLUG-IN AND TURN ON THE TERMINAL 
_ SET THE TERMINAL SWITCHES 


IF HARDWIRED TERMINAL 


l IDENTIFY YOURSELF VIA THE login COMMAND 


IF TELEPHONE-MODEM TERMINAL 
I DIAL THE APPROPRIATE NUMBER AND WAIT FOR HIGH-PITCHED TONE 
1 CONNECT THE PHONE TO THE COUPLER DEVICE 


1 WAIT FOR MULTICS TO RESPOND WITH A MESSAGE SIMILAR TO: 


Multics MR6.0: Honeywell LISD Phoenix, System M 
Load = 51.0 out of 95.0 units: users = 51 


A 


oa 


) IDENTIFY YOURSELF VIA THE login QOMMAND 
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LOGIN AND LOGOUT COMMANDS 


login, l 


A COMMAND USED TO GAIN ACCESS TO MULTICS 
INITIATES A PROGRAM CALLED THE USER'S PROCESS 


USAGE: | login Person _id {Project id} 
1 TSmith 


1 TSmith FED 
1 Student_07 FO1 


IF A Project_id IS NOT SPECIFIED THE USER'S DEFAULT Project id 
IS ASSUMED 


RESULTS: THE USER WILL BE ASKED TO SUPPLY THE PASSWORD 
ASSOCIATED WITH HIS Person_id | 


l A PASSWORD MASK WILL BE GENERATED -OR- PRINTING OF THE 
PASSWORD WILL BE INHIBITED 


l SUPPLYING THE CORRECT PASSWORD COMPLETES THE USER'S LOG IN 
SEQUENCE : 


THE Project_id USED AT LOG IN DETERMINES WHO RECEIVES THE BILL 
FOR THE CURRENT TERMINAL SESSION 


THE Person_id AND Project id USED AT LOG IN DETERMINES WHERE IN 
THE MULTICS VIRTUAL MEMORY THE USER "FINDS" HIMSELF 
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N AND LOGOUT COMMANDS 


<DIAL TELEPHONE NUMBER> 
<CONNECT TERMINAL/TELEPHONE> 
<WAIT FOR LOGIN HERALD> 


Multics MR6.0: Honeywell LISD Phoenix, System M 
Load = 51.0 out of 95.0 units: users = 51 


1 TSmith 
Password 
BEREREEBRRERR | 
TSmith ProjA logged in 06/28/77 1553.2 mst Tue from terminal "243". 
Last login 06/28/77 1425.8 mst Tue from terminal "013" 
A new PL/1 compiler was installed; type help new _pll. 
Type help sked for hours of operation FW31. 

r 1553.5 1.314 1.332 30 


@ READY MESSAGE 


A MESSAGE THAT IS PRINTED EACH TIME THE USER IS AT "COMMAND 
LEVEL" 


0 THE READY MESSAGE REPORTS 
2 THE TIME OF DAY 
d THE NUMBER OF CPU SECONDS USED SINCE THE LAST READY MESSAGE 
1 THE NUMBER OF MEMORY UNITS USED SINCE THE LAST READY MESSAGE 


) THE NUMBER OF PAGES (1024 WORDS) BROUGHT INTO MEMORY FOR THE 
USER SINCE THE LAST READY MESSAGE 
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LOGIN AND LOGOUT COMMANDS 


Camemnrecerene 


® logout 


INFORMS MULTICS THAT THE USER IS THROUGH WITH THE CURRENT 
TERMINAL SESSION 


J USAGE: logout 


0 RESULTS: THE USER WILL BE DISCONNECTED FROM MULTICS 


! logout 
TSmith ProjA logged out 06/28/77 1749.4 mst Tue 
CPU usage 17 sec, memory usage 103.1 units 
hangup 
@ new _proc 
1 DESTROYS THE USER'S CURRENT PROCESS AND CREATES A NEW ONE 


f EFFECTIVELY THE SAME AS LOGGING OUT AND LOGGING IN AGAIN 


0 OFTEN USED "WHEN ALL ELSE FAILS" OR TO RESET THE USER'S 
ENVIRONMENT | 


) USAGE: new_proe 
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TYPING CONVENTIONS 


@ # (NUMBER SIGN) 


1 USED TO "ERASE" THE PREVIOUS CHARACTER 


login TSM#mith 
login TSMith####mith 
logen##in TSme#ith 


logim T###n TSmith 


0 NOTE: WHITE SPACE IS COUNTED AS ONE CHARACTER WHEN USING. THE 
ERASE CHARACTER 


#® @ (AT SIGN) 


1 USED TO "KILL" THE CURRENT LINE 


login TSMith@login TSmith 
logen@login TSme#ith 


logen##im#n Tsm##Sme@login TSmith 


FO 1 


TYPING CONVENTIONS 


\ (BACKSLASH) 


1 THE CHARACTER \ IS’ A FRONT-END PROCESSOR ESCAPE SEQUENCE THAT 


CAUSES CERTAIN CHARACTER THAT FOLLOWS TO BE INTERPRETED AS A 
LITERAL 


J OFTEN USED TO SUPPRESS (ESCAPE) THE SPECIAL MEANING OF #, @, 
linefeed AND OTHER SPECIAL CHARACTERS 


sm TSmith.ProjA I need a \#8 tin can. 


sm TSmith.ProjA He's selling 3 \@ $4.50 each. 


COMMAND LINE FLOW 


TYPED LINE (AT THE TERMINAL) 
FRONT-END PROCESSOR C# AND @ EDITING AND LINE DISCIPLINE) 
COMMAND PROCESSOR (INTERPRETS THE TxeeP LINE) 

EXECUTION 


who 


SOME SIMPLE COMMANDS 


J LISTS THE NAMES AND PROJECTS OF ALL USERS CURRENTLY LOGGED IN 


l 


-USAGE: 


who 
who 
who 
who 
who 
who 


who 


{args} {-control_ args} 


-name 

-long 

TSmith 

-ProjA 

May .FO1 .ProjA 


how_many_users, hmu 


TELLS HOW MANY USERS ARE CURRENTLY LOGGED IN 


USAGE: 


how_many_users {args} {-control_ args} 


hmu 


hmu -long 


hmu TSmith 


hmu .ProjA 


hmu May .FO1 .Proja 


FO1 


SOME SIMPLE COMMANDS 


@ help (YA WANT IT, WE GOT IT) 


J PROVIDES INFORMATION ABOUT THE MULTICS SYSTEM AND ITS COMMANDS 


I USAGE: help {name} 
help who 
help sked 
help help 


1 ANSWER: ves, no, rest 


® list, ls (ROLL CALL) 


J RETURNS INFORMATION ABOUT THE USERS SEGMENTS (FILES) 


] USAGE: list 


ls 


N 


~12 


SOME SIMPLE COMMANDS 


accept messages, am (I'M LISTENING) 


= 


ENABLES THE USER TO RECEIVE MESSAGES AT HIS TERMINAL 


I OTHERWISE, MESSAGES WILL GO TO THE USER'S MAILBOX (A SEGMENT 
HAVING THE NAME Person_id.mbx) | 


J CREATES A PERMANENT MAILBOX FOR THE USER IF NONE EXISTS 
I USAGE: accept_messages 
am 
send message, sm 
J SENDS MESSAGES TO A GIVEN USER ON A GIVEN PROJECT 


I MESSAGES ARE EITHER: 


I PRINTED ON THE RECIPIENT'S TERMINAL, OR 


— PLACED IN THE RECIPIENT'S MAILBOX 
I USAGE: send_message Person_id.Project_id message 


sm TSmith.ProjA When are you going to lunch? 


sm Greenberg.FED May I have access to your file? 


SOME SIMPLE COMMANDS 


print messages, pm 
0 PRINTS ALL MESSAGES STORED cn aN MAILBOX — 
] MESSAGES ARE DELETED FROM THE MAILBOX WHEN PRINTED 
1 USAGE: print _messages 
pm 
defer messages, dm (I'M BUSY...NO sieiactiols WANTED) 
0 REDIRECTS ANY AND ALL INCOMING MESSAGES TO THE USER'S MAILBOX 
] ELIMINATES UMMA SLer INTERRUPTIONS 
1 THIS IS THE DEFAULT UPON LOGIN 
1 "UNDONE" BY THE accept message COMMAND 


] USAGE: defer _messages 
dm 


No 
' 

—_d 

{f= 
3 | 
eo) 


—_tk 


SOME SIMPLE COMMANDS . 


YOU ARE NOW READY FOR WORKSHOP 
#1 
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TOPIC III 


QEDX BASICS 


WhEG 2S. 5GO0S:. we: 4 ee Gh Br ree SE A ee ak ee ee we a 
qedx Concepts . . 2. 6 6 6 «© © © © © © ow ew ew ew et he hl tle) BH 
Basic qedx Requests . . . . «© «© «© © © «© © we ew we ) 
Basic qedx Examples ....... + « «© e ew « 3 
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qgedx, qx 


f ONE OF SEVERAL TEXT EDITORS AVAILABLE ON MULTICS USED TO 
0 MODIFY THE CONTENTS OF EXISTING ASCII SEGMENTS 


dD CREATE (INPUT) THE CONTENTS OF DESIRED ASCII SEGMENTS — 


0 A SUBSYSTEM WHICH CAN ONLY BE ENTERED BY COMMAND, AND EXITED BY 
REQUEST - 


qedx ° 


qx 


COMMAND LINE FLOW 


TYPED LINE 
FRONT-END PROCESSOR 
qedx SUBSYSTEM 


EXECUTION 
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QEDX CONCEPTS 


@ USER INVOKES THE EDITOR BY TYPING qedx OR qx 


@® THERE ARE TWO PRINCIPAL MODES OF OPERATION WITHIN qedx 


) EDIT MODE 


] THE INITIAL (DEFAULT) MODE WHEN ENTERING qedx 


I 


0 


THE USER READS THE CONTENTS OF AN EXISTING SEGMENT INTO A 
BUFFER (A SCRATCH PAD) 


THE USER THEN PERFORMS EDITING FUNCTIONS ON THE CONTENTS OF 
THE BUFFER BY TYPING EDIT REQUESTS: 

1 LOCATING 

J SUBSTITUTING 

J DELETING 

] PRINTING 


THE USER THEN WRITES (SAVES) THE EDITED VERSION OF THE 
SEGMENT BACK TO THE SAME (OR A NEW) SEGMENT 


] INPUT MODE 


l 


l 


THE USER ENTERS THE INPUT MODE (FROM THE EDIT MODE) BY 
TYPING ONE OF THREE INPUT REQUESTS 


ALL SUBSEQUENT TEXT FROM THE TERMINAL (EXCEPT ESCAPE 
SEQUENCES) IS APPENDED TO THE USER'S BUFFER (A SCRATCH PAD) 


"\f" IS AN ESCAPE SEQUENCE THAT RETURNS THE USER TO THE EDI1 


Arr 


MODE 
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QEDX CONCEPTS 


ALL LINES IN A gedx BUFFER ARE GIVEN IMAGINARY LINE NUMBERS 
STARTING WITH 1 (ONE) 


THERE EXISTS A CONCEPTUAL POINTER TO INDICATE THE "CURRENT LINE" 


qedx REQUESTS MAY DO ONE OR MORE OF THE FOLLOWING 
‘(| MOVE THE CONCEPTUAL POINTER 
] PERFORM OPERATIONS ON THE CURRENT LINE 


] PERFORMS OPERATIONS ON A SET OF LINES WITH 1 (ONE) 


ALL LINES CAN BE ADDRESSED BY SUPPLYING THEIR LINE NUMBER. 
NO LINE NUMBER IMPLIES "CURRENT LINE" 


p (PRINT CURRENT LINE) 
5p (PRINT THE FIFTH LINE) 
3,9d (DELETE LINES 3 THROUGH 9) 
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QEDX CONCEPTS 


THE ADDITION AND DELETION OF LINES AFFECT THE IMAGINARY LINE 
NUMBERS IMMEDIATELY 


AFTER EACH gedx REQUEST, THE "CURRENT LINE" GENERALLY BECOMES THE 
LAST LINE ADDRESSED 


FOR CONVENIENCE, THE LAST LINE CAN ALSO BE ADDRESSED BY USI". -HE 
SYMBOL $ (DOLLAR SIGN) 
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EDIT REQUESTS 


r path 


/XxX/ 


s/existing/new/ 


w path 


e command line 


BASIC QEDX REQUESTS 


DESCRIPTION 


READ: READ CONTENTS OF THE SEGMENT 
SPECIFIED BY path AND APPEND AFTER THE 
SPECIFIED LINE ($ ASSUMED) 


PRINT: PRINT THE SPECIFIED LINE(S) ON THE 
TERMINAL : 


{ 


LINE NUMBER: PRINT LINE NUMBER OF SPECIFIED 
LINE 


DELETE: DELETE SPECIFIED LINE(S} FROM THE 
BUFFER 


LOCATE: LOCATE AND PRINT THE NEXT LINE 
CONTAINING THE xxx CHARACTER STRING. WRAP 
AROUND IF NECESSARY 


SUBSTITUTE: SUBSTITUTE EVERY OCCURRENCE OF 
THE EXISTING STRING WITH THE NEW CHARACTER 
STRING IN SPECIFIED LINE(S) 


WRITE: WRITE THE SPECIFIED LINE(S) OF THE 
BUFFER INTO SEGMENT HAVING THE NAME path 
(ENTIRE BUFFER IS THE DEFAULT) 


EXECUTE: PASS THE REMAINDER OF THE REQUEST 
LINE TO THE MULTICS COMMAND PROCESSOR FOR 
EXECUTION 


QUIT: EXIT FROM THE EDITOR 
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INPUT REQUESTS 


a 


\f | a Peet Cm 


BASIC QEDX REQUESTS 


DESCRIPTION 


APPEND: ENTER INPUT 
LINE(S) TYPED AT THE 


SPECIFIED LINE. 


INSERT: ENTER INPUT 
LINE(S) TYPED AT THE 
SPECIFIED LINE 


CHANGE: 
SPECIFIED LINE(S) 
THE TERMINAL 


——s 


3-6 


MODE AND 
TERMINAL 


APPEND THE 
AFTER THE 


MODE AND INSERT THE 
TERMINAL BEFORE THE 


ENTER INPUT MODE AND REPLACE THE 
WITH THE LINE(S) TYPED AT 


FO 


BASIC QEDX REQUESTS 


tivteg 


| | 2. ey oy oe 
@® ADDRESSING SIN 5 Con ene Mase im any Co CoO 


i qedx REQUEST MAY TAKE ONE OF THREE GENERAL FORMS: 


I <request> - GENERALLY APPLIED TO THE CURRENT LINE 


r temp.pl1 (APPENDS TO END OF BUFFER) 


p 
s/old/new/ 
d 


w add.pli (WRITES THE ENTIRE BUFFER) 


J ADR<request> - APPLIED TO THE LINE ADDRESSED 


6r >udd>FED>Kerr>temp.pl1 
2p 

7s/old/new/ 

9d 

3w add.plt 


1 ADR,ADR<request> - APPLIED TO THE RANGE OF LINES ey ee 
itp y ey 
5,15s/old/new/ | 


9,12d 


1,20w add.pli 
1 ot Are KREQUEED RELATIVE 


Con TEXT 


EST> 
Il [xx R REE 3-7 FO1 


om Cop Sap Com OCW 


BASIC QEDX EXAMPLES 


qedx 
a 


"Now is hte time 


for al good 
ir county 
\f/ 


tthe 


1,$p 

"Now is hte time 
for al good. 
their county 

2p 

for al good 
s/al/all/ 
$s/ty/try."/ 

p 

their country." 
w Henry.quote 


/good/ 
for all. good 
2 | 


men to come 
to hte aid of 
1,$p | 
\f 


RESULTING BUFFER 


"Now is hte time 


for al good 
their county 


"Now is hte time 
for all good 
their country." 


RESULTING BUFFER 


"Now is hte time 
for all good 
men to come 


to hte aid of 
1,$p 
their country." 


AUN EWwh — 


FQ} 


em Cap OD Cap Gum Of SCOR CoD CoD 


BASIC QEDX EXAMPLES 


RESULTING BUFFER 


b 
1,$p 

d 

1,$s/hte/the/ =} 
w Henry.quote 


1,$d 


gr Henry.quote 
p 


their country." 
a 
" 


Now is the time 


for all good 
men to come 
to the aid of 
their country." 


RESULTING BUFFER 


a 7 
| -Patrick Henry =>] -Patrick Henry 
\f | | 


RESULTING BUFFER 


FAMOUS QUOTE: 


Now is the time 


\f for all good 
1i men to come 


FAMOUS QUOTE: 


to the aid of 


their country." 


ay 
w Henry.quote 


YOU ARE NOW READY FOR WORKSHOP 
#2 


S29 


-Patrick Henry 


FO1 
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TOPIC IV 


MORE QEDX 


Page 
qedx Terminology . ee. sar ed Ger “ain Mee ce. ah Ade tet oe, Sas ee ST 
Special eens Ge vis ae LOE BE Be Be. ae Be, 8S I. te ee eS ew ee 
Examples a ‘ a | 46 
Addressing. bade. Se be See Meee BE Uke ak he a ee ae. es SF 
Additional Buffers. Cet cee a ee hak aa bo age Sb le Ales ee ee le ee 
Areas for Additional Study .. ‘ 4~10 
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QEDX TERMINOLOGY 


& _ REGULAR ES: : 


f ANY NUMBER OF CHARACTERS (INCLUDING NONE) DELIMITED BY A RIGHT 
SLANT AND OBEYING A CERTAIN SYNTAX 


/abe/ | /a.ce/ 
/old/ /old.*$/ 
/calendar/ /“calendar/ 


@ SEARCH EXPRESSION: 
Be ee 


1 A REGULAR EXPRESSION IMMEDIATELY FOLLOWING A qedx REQUEST. 
(/abc/ IN THESE EXAMPLES) | : | 


s/abe/xyz/ 
-1,25s/abe// 
/abc/ 


@ REPLACE EXPRESSION: 


Se ce IES 


] THE SECOND CHARACTER STRING IN A SUBSTITUTE REQUEST. (/abc/ IN 


THESE EXAMPLES) 
s/old/abe/ 


1,58s/old/abe/ 


ll FO1 


SPECIAL SYMBOLS 


@ / (RIGHT SLANT -OR- SLASH) 


1 DELIMITS A REGULAR EXPRESSION 


/abo/ 
/“character/ 


/ters.*$/ 


@ . (PERIOD) } 


AS PART OF AN ADDRESS IN A qedx REQUEST 


1 ADDRESSES THE CURRENT LINE 


—S 
USAGE 2: 


AS A CHARACTER IN A SEARCH EXPRESSION 


] MATCHES ANY CHARACTER 


/a.c/ MATCHES: aac 
abe 
aze 
ac 

..etec 
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SPECIAL SYMBOLS 


oe * (ASTERISK) 


) HAS SPECIAL MEANING ONLY IN A SEARCH EXPRESSION 


a arene 


1 MEANS ANY NUMBER (INCLUDING NONE) OF THE PRECEDING CHARACTER 
eS eee 


/ab*ec/ MATCHES: ac 
abe 
abbe 
abbbe 
.. ete 


/a.*c/ MATCHES: ac 
aXxc 
axyze 
.. etc 


# $ (DOLLAR) 


AS PART OF AN ADDRESS IN A qedx REQUEST 


I ADDRESSES THE LAST LINE OF THE USER'S BUFFER 


1,$p 
$d 


J USAGE 2: / AS THE LAST CHARACTER OF A SEARCH EXPRESSION 


J MATCHES THE END OF A LINE (I.E., THE IMAGINARY CHARACTER 
FOLLOWING THE LAST CHARACTER OF A LINE) 


/ealendar$/ MATCHES: calendar 
IF "calendar" ENDS A LINE 


Yu 3 FO1 


SPECIAL SYMBOLS 


f HAS SPECIAL MEANING ONLY AS THE FIRST CHARACTER OF A SEARCH 
EXPRESSION 7 


l MATCHES THE BEGINNING OF A LINE (I.E. . AN IMAGINARY CHARACTER 
PRECEDING THE FIRST CHARACTER ON A LINE) 


/“calendar/ MATCHES: calendar 
IF "calendar" BEGINS A LINE 


ae 


@ & (AMPERSAND) 


1 HAS SPECIAL MEANING ONLY IN THE -REPLACE EXPRESSION OF A 
SUBSTITUTE REQUEST 


1 EACH & IS REPLACED BY THE STRING WHICH MATCHED THE REGULAR 
EXPRESSION IN THE SEARCH EXPRESSION 


s/camp/é&ing/ SAME AS: s/camp/camping/ 
s/junk/"&"/ SAME AS: — s/junk/"junk"/ 
s/ab/&&&/ SAME AS: — s/ab/ababab/ 


s/a.c/&def/ SAME AS: s/aac/aacdef/ 
: s/abc/abcdef/ 
S/azc/azcedef/ 
s/a c/a cdef/ 
-. ete 
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SPECIAL SYMBOLS 


@ // (DOUBLE RIGHT SLANT - OR - SLASH SLASH) 


f USAGE i;) AS THE REPLACE EXPRESSION OF A SUBSTITUTE REQUEST 


1 THE REPLACE EXPRESSION IS THE NULL STRING (A MEANS OF 
DELETING EXISTING CHARACTER STRINGS) 


s/abe// 


AS A SEARCH EXPRESSION 


 qedx REMEMBERS THE LAST SEARCH EXPRESSION DEFINED BY THE 
USER | 


l // STANDS FOR THE LAST SEARCH EXPRESSION DEFINED 


/a.c/ 


/a.c/ 
s//xyz/ SAME AS: | s/a.c/xyz/ 
// ta.e/ 


@ \c (LEFT SLANT C -OR- BACKSLASH C) 


) THE SEQUENCE \e IS A qedx ESCAPE SEQUENCE THAT CAUSES THE 
CHARACTER THAT FOLLOWS TO BE INTERPRETED AS A LITERAL 


l SUPPRESSES (ESCAPES) THE SPECIAL MEANING OF qedx SPECIAL 
SYMBOLS 


fa te.b/ 
s/\c*echpplex/*echoplex/ 
s/ab«:/\c&def/ 
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EXAMPLES 


@ INTERPRET THE FOLLOWING qedx REQUESTS: 


1,$s/a...b// 
1,$s/a...b/&&/ 
1,$s/a.*b/xyz/ 
1,$s/a..*b/xyz/ 
1,$s/a.\c.*b/xyz/ 
1,$s/a..\co*b/xyz/ 
1,$s/*a...b// 


1,$s/./a/ 

1,$s/./&&/ 

1,$8/.#/&&/ 
1,$s/"a*b*#ct#d/abed/ 
1,$s/*a.*b.%c.*#d/abed/ 
1,$s/* *// 

1,$s/*  */ ae / 
1,$8/7>.$/&&&/ 


AWG 


ADDRESSING 


® qedx REQUEST MAY TAKE ONE OF THREE GENERAL FORMS 
] <request> 
1 ADR<request> 


2 ADR,ADR<request> 


@ ADDRESSES MAY TAKE ONE OF THREE GENERAL FORMS. 


1 ABSOLUTE LINE NUMBERS 
5d 
'$p 
10, 12s/abe/xyz/ 
; 


l RELATIVE LINE NUMBERS (RELATIVE TO "CURRENT LINE") 
.+4d 
+4d 
-~2,.p 
-2,+5s/abe/xyz/ 
$-4,$p 
-2 
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CONTEXTUAL ADDRESSING 


J AN ADDRESS MAY BE A REGULAR EXPRESSION 


ADDRESSING 


‘d oA LINE CAN BE 


/abe/d 
/abe/,25p 


‘/abe/+2,25p 


/abe/+2,+25p 


-4,/x.2/p 


ADDRESSED BY MATC 
STRINGS IN THE LINE 


u 


ING 


EGULAR EXPRESSIONS TO 


/“abteo/+2,/x.z/-3s/boat /boating / 
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FO 


@ THE USER'S 
b(0) 


ADDITIONAL ‘BUFFERS 


ameter scat bemrtna ete SEPT 


INITIAL BUFFER (SCRATCH PAD) HAS A RESERVED NAME OF 


@ USERS MAY DEFINE AN ARBITRARY NUMBER OF ADDITIONAL BUFFERS BY 
SIMPLY REFERRING TO THEM BY SOME CHOSEN NAME 


BUFFER REQUESTS 


m( name) 


\b( name) 


b( name) 


DESCRIPTION 


MOVE: MOVE THE SPECIFIED LINE OR LINES IN THE 


CURRENT BUFFER TO A BUFFER HAVING THE SPECIFIED 


NAME 
REPRESENTS THE CONTENTS OF THE SPECIFIED BUFFER 


BUFFER: CHANGE BUFFERS. MAKE THE SPECIFIED 
BUFFER THE "CURRENT" BUFFER 


STATUS: PRINT A SUMMARY OF THE STATUS OF ALL 
BUFFERS a, 


4 


@ CUT AND PASTE EXAMPLE. MOVE LINES 14 THROUGH 17 IMMEDIATELY BELOW 


LINE 10 


14,17m(1). 


10a 


\b(1)\f_ 
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AREAS FOR ADDITIONAL STUDY 


@ ADDITIONAL DOCUMENTATION OF qedx 
7) MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 
] NEW USER'S GUIDE (AL40) 


1 help qedx 


® STUDY TOPICS 
1 MULTIPLE REQUEST ON A LINE 
dp 
s/abe/xyz/p 
s/abe/xyz/w file 13 
\fw | 
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AREAS FOR ADDITIONAL STUDY 


ADDITIONAL qedx EDIT REQUESTS - 
g (global) =a Wi ; 


gp/xyz/ 
1,10gd/xyz/ 
10, 20g=/xyz/ 


v (exclude) 


vp/xyz/ 
1,10vd/xyz/ 


1,.ve/xyz/ 
n= (nothing) 
5n 
" (comment) 


"This is a comment in a macro 
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AREAS FOR ADDITIONAL STUDY 


ADDRESSING USING ";" INSTEAD OF "," 
ADR ; ADR<request> 
/abe/;+5d 


DELIMITERS OTHER THAN "/" 
RESERVED BUFFERS: b(0), b(exec), b(args) 


qedx MACRO FACILITY 


I BY TYPING THE FOLLOWING COMMAND LINE: 
qedx my _macro.qedx add 


THE FOLLOWING MACRO IS INVOKED WITH BUFFER 
CONTAINING THE ARGUMENT add 


my _macro.qedx 


r \b(args) .fortran 
1,$s/write.*)/print/ 


W 
q 


b( args) 
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TOPIC V 


THE STORAGE SYSTEM 


SEGMOENCS) cs G8 <0 Se ee Tet ao Se a ww as ae A cw 
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Storage System Control . . 2. 1. 6. © ee ww ew ew ww we ew) 58 
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@ SYSTEM GOALS: 


l DECENTRALIZATION OF THE SYSTEM'S LOGICAL FILE SPACE 


1 EASE OF USE 


@ EFFECT ON STORAGE SYSTEM 
1 HIERARCHY OF DIRECTORIES 


] PATHNAME CONVENTION 


>udd>FED>LJones>tools>my_editor 


0 WORKING DIRECTORY CONCEPT 


change wdir >udd>FED>LJones>tools 
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SEGMENTS 


pos fon Cet 


SEGMENT 
1 THE BASIC UNIT OF INFORMATION STORAGE 
] SOMETIMES REFERRED TO AS A FILE 


] SEGMENTS RESIDE ON DISK PACKS (SECONDARY STORAGE) 


f SIZE IS INTEGER NUMBER OF RECORDS (1024 WORDS). 0,1,2,3... 


0 MAXIMUM SIZE IS 256 RECORDS (256K WORDS) 


ALL SEGMENTS HAVE AT LEAST ONE GIVEN NAME (ENTRYNAME) 
home work 3 


add.plt1 


start _up.ec 
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SEGMENTS | 


@ MUST DISTINGUISH BETWEEN THE CONTENTS OF A SEGMENT AND THE 
ATTRIBUTES OF A SEGMENT _ 


, THE CONTENTS OF & SEGMENT MAY BE: 
] DATA (EITHER RAW OR FORMATTED) 
1 TEXT (USUALLY ASCIT) 
I SOURCE OR OBJECT PROGRAM 


1 EMPTY (ZERO LENGTH) 


] SOME ATTRIBUTES OF A SEGMENT ARE: 
1 THE NAME(S) OF THE SEGMENT (CALLED ENTRYNAME(S)) 


) THE SEGMENTS UNIQUE IDENTIFIER (A UNIQUE, 36 BIT, INTERNALLY 
USED NAME) 


I THE AUTHOR (I.E., THE user_id OF THE CREATOR) 
l THE LENGTH (IN BITS) OF THE SEGMENTS CONTENTS 


] THE BIT COUNT AUTHOR (I.E. THE user_id OF THE LAST PERSON 
TO MODIFY THE CONTENTS) | 


1 THE ACCESS CONTROL LIST SPECIFYING WHO MAY ACCESS THE 
SEGMENT AND HOW THEY MAY ACCESS IT 


1 THE AMOUNT OF DISK’ SPACE (IN RECORDS) OCCUPIED BY THE 
SEGMENT 
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1 DATE AND TIME SEGMENT'S CONTENTS WERE LAST MODIFIED 
0 DATE AND TIME THE SEGMENT'S ATTRIBUTES WERE LAST MODIFIED 


DATE AND TIME SEGMENT'S CONTENTS WERE LAST DUMPED (I.E. 
COPIED TO TAPE BY THE MULTICS BACKUP Ener DURES 


= 


1 DATE AND TIME SEGMENT'S CONTENTS WERE LAST REFERENCED 
J THE STATE OF THE SEGMENT'S COPY SWITCH 


) THE STATE OF THE SEGMENT'S SAFETY SWITCH 


THE CONTENTS OF A SEGMENT MAY BE READ BY USING THE print COMMAND 
OR qedx's "r" AND "p" REQUESTS 


THE ATTRIBUTES OF A SEGMENT MAY BE OBTAINED BY USING THE list OR 
THE status COMMAND 


THE ACCESSING OF A SEGMENT'S CONTENTS AND A SEGMENT'S ATTRIBUTES 
ARE INDEPENDENTLY CONTROLLED BY THE MULTICS ACCESS CONTROL 
MECHANISM 
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CONTENTS 


The Multics System i 
S a general purpose 
computer system deve 
loped by the\012Mass 
achusetts Institute 
of Technology and H 
oneywell Infor-\012 
mation Systems. Int 


1 markets\012in Janu 
ary 1973, Multics w 
as then the result o 
f more than 7 years 

of research.\012 


roduced to commercia 


SEGMENTS 


ATTRIBUTES 


names: 
author: 


access: 


bit count: 


records used: 


date modified: 


date dumped: 


date used: 


ATTRIBUTE VALUE 


home work 3, hw3 
May.FED.a 


rw  May.FED.* 
row * .SysDaemon.* 


49698 

2 

03/21/77 1034.4 mst 
03/21/77 1051.0 mst 
09/07/77. 0818.9 mst 


MAY HAVE UP TO 19 MILLION SEGMENTS IN A preten (512 MSU * 198s 000 
SEGMENTS ) 


ME SEGMENTS CONTAIN THE NAMES, 
Canela ATTRIBUTES OF OTHER S 


Be a Se a ee 
THESE SEGMENTS SERVE AS A CATALOG OF THE OTHER SEGMENTS 


J 


THESE "CATALOG" SEGMENTS\ARE CALLED DIRECTORIES) 


D, 
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DIRECTORIES 


@ DIRECTORY 


1 A SEGMENT CONTAINING THE NAMES, ‘ADDRESSES AND ATTRIBUTES OF 
OTHER SEGMENTS AND/OR OTHER STORAGE SYSTEM ENTITIES | 


1 A MEANS OF ORGANIZING (CATALOGING) SEGMENTS AND/OR OTHER 
STORAGE SYSTEM ENTITIES 


1 SPECIFICALLY, A DIRECTORY MAY BE A CATALOG OF THE FOLLOWING 
STORAGE SYSTEM ENTITIES: 


re 


1 SEGMENTS (SINGLE SEGMENT FILES) 
2 MULTISEGMENT FILES 


J OTHER DIRECTORIES 
1 LINKS 


MAY BE EMPTY 


i —— | 


@ ALL DIRECTORIES HAVE AT LEAST ONE GIVEN NAME (ENTRYNAME) 


udd wae drockevy deackevw 
FO1 
Dir_A 


system library unbundled 
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DIRECTORIES 


Student 7 0 1 


Prince hw dir add.pl1 


Student 01 
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STORAGE SYSTEM CONTROL 


MAY HAVE UP TO 19 MILLION SEGMENTS IN A SYSTEM, SOMEONE MUST 
CONTROL: 


1 THE ALLOCATION OF DISK SPACE TO USERS (WHO GETS WHAT?) 
l THE CREATION AND USE OF SEGMENTS (I'VE GOT A SECRET!) 


1 THE SHARING OF SEGMENTS (YOU MAY USE MINE TOO!) 


HIERARCHY OF ADMINISTRATORS 
1 THE SYSTEM ADMINISTRATOR 
1 PROJECT ADMINISTRATORS 


f USERS 


5-8 FQ) 


STORAGE SYSTEM CONTROL 


SYSTEM 
ADMINISTRATOR 
ProjA PROJECT FO1 PROJECT 
ADMINISTRATOR ADMINISTRATOR 
USER USER USER USER} |USER]| |USER] [USER 


May Kerr Abel S_01} JS_02 1S 03 S_ 04] 
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STORAGE SYSTEM HIERARCHY 


NEED TO PARTITION THE FAMILIES OF DIRECTORIES AND SEGMENTS INTO 
MANAGEABLE COMMUNITIES 


STORAGE SYSTEM IS MAPPED ONTO ADMINISTRATION HIERARCHY 


peo 


ROOT 
DIRECTORY 


USER DIRECTORY ad 


DIRECTORY 


Proja | | FO1 
DIRECTORY DIRECTORY 


May | |Kerr| {Abel soit {s oz! ts o3! Js o4f 
DIR pin | [DIR pTR | |ptR DIR DIR 
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STORAGE SYSTEM HIERARCHY 
THE STORAGE HIERARCHY IS ANALOGOUS IN FORM TO AN INVERTED TREE 


THE USER DIRECTORY DIRECTORY (udd) EMANATES FROM THE ROOT 
DIRECTORY aia 3 


ALL PROJECT DIRECTORIES EMANATE FROM THE USER DIRECTCRY 
DIRECTORY (udd) 


ALL USER DIRECTORIES EMANATE FROM THEIR RESPECTIVE PROJECT 
DIRECTORIES 


USERS MAY ARBITRARILY CREATE DIRECTORIES SUBORDINATE TO THEIR OWN 
USER DIRECTORY - UP TO A MAXIMUM DIRECTORY DEPTH OF 16 (TOP TO 
BOTTOM). — — 


A SEGMENT WHOSE POSITION IS IMMEDIATELY BELOW A GIVEN DIRECTORY IS 
SAID TO BE: | 


"In the directory" 
~ OR - 
"Under the directory" 


5-11 FO1 


STORAGE SYSTEM HIERARCHY 


system library 
standard 


user dir dir 


_dir_ ,{system_library_ 
(udd) 


unbundled 


ProjA a a FO1 
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PATHNAME CONVENTIONS 


@ ABSOLUTE PATHNAME 


1 A PATHNAME THAT UNIQUELY IDENTIFIES A SEGMENT (OR DIRECTORY) BY 


ITS ABSOLUTE POSITION IN THE DIRECTORY HIERARCHY 


FORMED BY CONCATENATING A SEGMENT'S (OR DIRECTORY'S) ENTRYNAME 
WITH ALL SUPERIOR DIRECTORIES LEADING BACK TO THE ROOT 


>udd>F01>Student_01>add.pl1 


THE > _ (GREATER-THAN) CHARACTER IS USED TO SEPARATE THE 
ENTRYNAMES IN A PATHNAME | 


4 


AN ABSOLUTE PATHNAME ALWAYS BEGINS WITH > (GREATER-THAN) 


0 DIRECTORY ABSOLUTE PATHNAMES 
>udd>Proja 
udd>F01>Student_01 


>udd>FO1>Student 01>hw_ dir 


? SEGMENT ABSOLUTE PATHNAMES 
>udd>FO1>Student_01>add.pl11 
>udd>FO1>Student_01>hw_dir>lesson_2 


>udd>ProjA>Kerr>start_up.ec 


5-13 FQ1 


PATHNAME CONVENTIONS 


NOTICE THAT AN ABSOLUTE PATHNAME SUCH AS 
>udd>ProjA>Kerr>start up.ec 


IDENTIFIES: : 
l THE ENTRYNAME OF THE. SEGMENT (start _up.ec) 


1 THE Person_id OF THE "OWNER" (Kerr) 


i+ — | 
3 
oe 
t™} 
0 
3 
) 
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PATHNAME CONVENTIONS 


@® HOME DIRECTORY (WHERE THE HEART IS) 


f THE DIRECTORY IN WHICH THE USER "FINDS" HIMSELF IMMEDIATELY 
AFTER LOG IN 


] THE INITIAL WORKING. DIRECTORY 
(a ea a 


1 THE Person_id AND Project id GIVEN AT LOG IN DETERMINE THE HCME 
DIRECTORY 


l IS GENERALLY: >udd>Project id>Person_id 


>udd>F01>Student_02 
>udd>ProjA>Abel 


@ WORKING DIRECTORY (WHERE THE ACTION IS) 


1 THE DIRECTORY’ IN WHICH THE USER IS CURRENTLY WORKING (THE 
INITIAL WORKING DIRECTORY IS THE HOME DIRECTORY) 


1 THE USER MAY CHANGE HIS WORKING DIRECTORY, AS DESIRED, TO ANY 
OTHER DIRECTORY IN THE STORAGE SYSTEM 


1 COMMANDS SUCH AS list AND qedx's "r" and "w" WILL OPERATE ON. 
THE SEGMENTS IN THE USER'S WORKING DIRECTORY 
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PATHNAME CONVENTIONS 


RELATIVE PATHNAME 


l A PATHNAME THAT UNIQUELY IDENTIFIES A SEGMENT (OR DIRECTORY) BY 
ITS POSITION RELATIVE TO THE USER'S WORKING DIRECTORY 


NEVER BEGINS WITH > (GREATER-THAN) 
[ITT ie 


1 DIRECTORY RELATIVE PATHNAME 


ProjA 
udd>ProjaA 


Student 01 
FO>Student _o1 


ww US wh wb 


hw dir 
Student 01>hw dir 
FO1>Student_01>hw_dir 


0 SEGMENT RELATIVE PATHNAMES 


add.pli 
Student_01>add.pli 


lesson 2 
hw_dir>lesson 2 


Start _up.ec 


Kerr>start_up.ec 
ProjA>Kerr>start_ up.ec 


THE WORKING DIRECTORY CONCEPT IS SIMPLY A CONVENIENCE THAT ALLOWS 
THE USER TO TYPE RELATIVE PATHNAMES INSTEAD OF THE LONGER ABSOLUTE 
PATHNAMES 


FG pare. fh eae er maid ~ 
< ’ a if y 
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PATHNAME CONVENTIONS 


ENTRYNAMES (PATHNAME MEMBER ) 


1 .1 TO 32 CHARACTERS LONG 


1 SHOULD NOT INCLUDE > < * = 2? % $ ™ (+) SPACE OR TAB 
l (UNDERSCORE) 


l SIMULATES A SPACE FOR READABILITY 


Bobs orig editor.pl1 


) . (PERIOD) 


1 SEPARATES COMPONENTS OF AN ENTRYNAME 


ms tester.old.fortran 
0 LAST COMPONENT OF AN ENTRYNAME IS CALLED THE SUFFIX 
] ENTRYNAMES MUST BE UNIQUE WITHIN A DIRECTORY 


] SEGMENTS AND DIRECTORIES MAY HAVE MORE THAN ONE ENTRYNAME 


test.14 may.new_ compiler homework_dir 
t.14m.ne hw_dir 
may _comp hw 
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PATHNAME CONVENTIONS 


@ NOTICE THAT IN THE SIMPLEST. CASE (WHERE A USER LOGS IN, CREATES 
AND EDITS HIS HOME DIRECTORY FILES) NO KNOWLEDGE OF THE HIERARCHY 
IS REQUIRED 
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TOPIC VI 


STORAGE SYSTEM COMMANDS 


Directory Manipulation Commands ......... 2.2... 6-1 
Segment Manipulation Commands ...... 2... +. «+. 653 
Storage System Examples ........-s. 6-1 


6-1 


FO1 


This page has intentionally 
been left blank. 
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DIRECTORY MANIPULATION COMMANDS 


a . 7 
® print_wair, pwd (WHERE AM 1?) 


pee ee A < 
et a 
. eee 


f PRINTS THE PATHNAME OF THE CURRENT WORKING DIRECTORY 


0 USAGE: print _wdir 


pwd 


wn 


a 


® poe A ewd (MOVE OUT!) 


\ = 


ee 


ma sma! 


) CHANGES THE USER'S WORKING DIRECTORY 


) USAGE: change wdir {path} 
cwd dir_A 
ewd >udd>FO1>Student_08>dir_A 


cwd 
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DIRECTORY MANIPULATION COMMANDS 


create dir, cd (UPTO 16 DEEP) 


ee 


0 CREATES AN EMPTY DIRECTORY 
) DOES NOT CHANGE THE USER'S WORKING DIRECTORY 


0 USAGE: create_dir paths {-control_ args} 
ed dir_A 


ed >udd>FO1>Student_09>myd 


delete_dir, dd (DO YOU REALLY...?) 


\ 
0 DELETES~{DESTROYS) SPECIFIED DIRECTORIES (AND ALL SUBORDINATE 
DIRECTORIES AND SEGMENTS) 


0 USAGE: delete_dir paths 


dd programs 


dd >udd>F01>Student_01>programs 
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SEGMENT MANIPULATION COMMANDS 


create, cr. (SELDOM NEEDED) 


— 


J CREATES AN EMPTY SEGMENT 


1 USAGE: create paths 
cr seg 1 
cr seg_1 seg 2 AB 


er >dudd>FO01>Student_07>add.pl1 


delete, dl 


f DELETES (DESTROYS) SPECIFIED SEGMENTS 


1 USAGE: delete paths 


dl seg _1 add.pli 
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ee 


wed 
aoa 


SEGMENT MANIPULATION COMMANDS 


1 COPIES A SPECIFIED SEGMENT TO A NEW POSITION IN THE HIERARCHY 


DOES NOT COPY A SEGMENT'S "ADD NAMES" UNLESS REQUESTED 


USAGE: copy path! {path2} {-control args} 


ep >udd>FED>LJones>add >udd>FED>LJones>exp>add 
cp >udd>FED>LJones>add add.old 
cp >udd>FED>LJones>add 


cp >udd>FED>LJones> add -name 


MOVES A SPECIFIED SEGMENT (TO INCLUDE ACL AND ADD NAMES) TO A 
NEW POSITION IN THE HIERARCHY 


USAGE: move pathi {path2} {-control_args} 
move >udd>FED>Kerr>dev>x_ sort >udd>FED>Kerr>tools>sort 
move >udd>FED>Kerr>dev>x_sort sort 


move >udd>FED>Kerr>dev>x_sort 
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SEGMENT MANIPULATION COMMANDS 


bg 


@ add name, an ead ee Poe 


\ 


1 ADDS ALTERNATE NAME(S) TO A SEGMENT OR DIRECTORY 
] SUCH NAMES ARE CALLED "ADD NAMES" 


0 USAGE: add_name path names 


an Seg _1.new@ 1.9 Gin) 
an >udd>FO1>Student 01>seg_1.new sin 


Pn aaa pepo | 
Pe | 


@ delete name, dn =: 


DELETES NAME(S) FROM SEGMENTS AND DIRECTORIES 


1 USAGE: delete name paths 


dn seg_1.new sin 
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SEGMENT MANIPULATION COMMANDS 


@® rename, rn. 


a 


No ® gta 


0 REPLACES A SEGMENT OR DIRECTORY NAME WITH ANOTHER 


1 USAGE: = rename pathi namel...pathn namen 


rn s_1.n seg _1.new 


® list; 1s / (ROLL CALL) 
{ —=— / 
ee 


Ne 
1 RETURNS ATTRIBUTE INFORMATION ABOUT STORAGE SYSTEM ENTITIES 
< ‘ : 4 f ayi yc § 
(porranenm ) Pop AGE) Hh abae’s | 
q 
Ki BY DEFAULT ONLY SEGMENTS ARE LISTED Be 5 is | 
popan nt 


0 USAGE: list {entrynames} {-control_args} 


ls 


ls add.pli seg_1 


yg rentidiiorne 
1s Car dorwlows ty — few ae a en F i 


ls -all -sort name 


list -date_ time contents modified 
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SEGMENT MANIPULATION COMMANDS 


cain 
we 


status, st (WHO, WHAT, WHERE, AND WHEN) 


"a on? 


RETURNS STATUS INFORMATION ABOUT SEGMENTS AND DIRECTORIES, 
INCLUDING —— —— 


1 DATE AND TIME MODIFIED, USED AND DUMPED 
) User_id OF AUTHOR AND User_id OF LAST MODIFIER 


q SIZE, ACCESS CLASS, ACCESS MODES, RING BRACKETS 


] USAGE: ~- status paths {-control_ args} 
| - St seg 1 
- St seg 1 -length 


- St seg 2 -author -date 


print, pr (<..LET'S SEE WHAT YOU LOOK LIKE) 


f PRINTS THE CONTENTS OF A SEGMENT 
Pitheche vial mii Petoctnh iL 


ee meen 


et 


q USAGE: print path {begin} {end} 
pr seg 1 
pr add.pli 150 
pr prince 40 120 
pr >udd>FO1>Student 08>add.pl11 
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SEGMENT MANIPULATION COMMANDS 


compose, comp (PLASTIC SURGERY) 


FORMATS TEXT SEGMENTS INTO MANUSCRIPT FORM 


\ 


SEGMENTS MUST HAVE SUFFIX OF compin AND NORMALLY CONTAIN 
CONTROL STATEMENTS WHICH DRIVE THE FORMATTING | as 


IF OUTPUT IS DIRECTED TO A SEGMENT, THE ENTRYNAME IS GIVE® A 
SUFFIX OF compout eo es 


CES THE runoff COMMAND, AND PROVIDES A 
ff CAPABILITIES TO INCLUDE INLINE ARTWORK 


USAGE: compose paths {-control_ args} 


comp thesis.compin 


comp thesis.compin -in 10 -of -dv dtc300s -pass 2 
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SEGMENT MANIPULATION COMMANDS 


@® dprint, dp (START THE PRESSES!) 


1 QUEUES A REQUEST TO PRINT THE CONTENTS OF A SPECIFIED SEGMENT 
ON THE LINE PRINTER | 


1 THE USER MAY SPECIFY ONE OF THREE PRIORITY QUEUES (QUEUE se 1s 
ASSUMED - LOWEST PRIORITY, LOWEST eest) 


1 THE PRINTING IS DONE BY ONE OF THE SYSTEM DAEMONS (A SERVICE 
PROCESS ) 


1 USAGE: dprint {-control_ args} {paths} 
dp seg_1 
dp -cp 4 -ds MD 104 seg 1 
dp seg _1 -cp 3 seg 2 -ds Bldg 4 seg 3 
dp -he "Tom Smith" -notify seg_1 add.pl1 


dp -delete -q 1 Prince 


f DEFAULTS: -cp 1, -ds Project_id, -he Person id, -q 3 
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SEGMENT MANIPULATION COMMANDS 


@ dpunch, dpn (START THE PUNCHES!) 


1 QUEUES A REQUEST TO PUNCH THE CONTENTS OF A SPECIFIED SEGMENT 
ON THE CARD PUNCH 


1 CONTROL. ARGUMENTS AND DEFAULTS ARE THE SAME AS THE dprint 
COMMAND 'S 


1 USAGE: dpunch {-control_ args} {paths} 


dpn -he Larry -ds "Room 21" prince 


& list_daemon_requests, 1dr a 
/ 


on oe 


Q PRINTS INFORMATION ABOUT OUTSTANDING aprane AND a REQUESTS 
IN A SPECIFIED QUEUE (DEFAULT IS -queue 3) 


) USAGE: list_daemon_requests {-control_ args} 
ldr 


ldr -queue 1 


SEGMENT MANIPULATION COMMANDS 


cancel_daemon request, cdr 


) CANCELS A dprint OR dpunch REQUEST IN THE QUEUE SPECIFIED 
(DEFAULT IS -queue 3) | 


USAGE: cancel_daemon_request request_id {-control_args} 
-edr prince 
edr -id 202008 


cdr -entry prince 


walk subtree, ws (AND DON'T COME BACK UNTIL YOU ARE THROUGH!) 


q EXECUTES ANY SUPPLIED COMMAND LINE IN A SPECIFIED ‘DIRECTORY, 
AND ALL INFERIOR DIRECTORIES © 


1 A LIBRARY MANAGEMENT TOOL 


] USAGE: walk subtree path "command line" {-control_args} 
ws >udd>FO1 "list -all". 
wS -wd "sa ## p #,# ,%N 


ws Cwd "da LJones.*.*" -bottom_up 


) 
a WORKME D (RECT CRS 
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STORAGE SYSTEM EXAMPLES 


NOTE: THE READY MESSAGE IS NOT SHOWN IN THE FOLLOWING TERMINAL 


SESSION 
W_DIR | 
\ fie | 
t pwd (print _wdir) 
>udd>F01>Student_01 (output) 
1 cis (ist) 
ate _-~~ Directory empty. (output) 
DA 
oy ! qx (qedx) 
! a (append mode) 
! add: proc (text) 
! end add (text) 
! \f (edit mode) 
! w add.plt | (write) 
: q (quit) 
! cr seg_1 Prince | (create) 
! ed hw_dir (create dir) 
W DIR 


* Student_01 


SS (rises = 
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STORAGE SYSTEM EXAMPLES 


_ pwd 
2udd>FO1>Student 01 


ls 


“ 
~_— 
* 


Segments = 3, Lengths 
rw QO Prince 

row O seg 1 

row 1 add.plt 


ls -sort name ~-all 


Segments = 3, Lengths = 1. 
row 1 add.plt 

row O seg 1 

row - 0 Prince 


Directories = 1. 

sma  hw_dir 

cr hw_dir>lesson_1.math 
ewd hw'dir 


pwd ; . 
Pudd>F01>Student_01>hw_dir 


cr lesson 12.eng 


(print _wdir) 


(output) 


(list) 

(output) 
(output) 
(output) 
(output) 
(output) 
(output) 


(list) 
(output) 


(output) 


(output) 
(output) 
(output) 
(output) 
(output) 
(output) 
(output) 
(output) 


(create) 


(change wdir) 


(print wdir) 


(output) 


(create) 


FO1 


STORAGE SYSTEM EXAMPLES 


Student_01 


{| lesson_1.math 


lesson_12.eng 
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STORAGE SYSTEM EXAMPLES 


ls lesson_12.eng | | y (list) 
Af (output) 
Segments = 1, Lengths = 0. | Ae] | (output) 
bs , (output) 
row O lesson_12.eng iP (output) 
fo Ate / 
ls -sort name -reverse(-dtu (list) 
| = | (output) 
Segments = 2, Lengths = 0. (output) 
| (output) 
09/13/77 0849.2 rw O lesson 12.eng (output) 
09/13/77 0849.1 rw 0 lesson_ 1smath (output) 
cwd | | (change wdir) 
pwd | | (print wdir) 
>udd>FO1>Student_01 (output) 
dp add.pl1 (dprint) 


1 request signalled, 22 already in queue 3 (output) 


ws -wd "ls ~briefn 


(walk subtree) 


(output) 

>udd>FO1>Student _01 (output) 

(output) 

Segments = 3, Lengths = 1. (output) 
(output) 

Prince 7 | (output) 
seg 1 | (output) 
add.pl1 | (output) 
: (output) 

>udd>F01>Student_01>hw_dir (output) 

| | (output) 

Segments = 2, Lengths = 0. (output) 
(output) 

lesson 12.eng (output) 
lesson _1.math (output) 


YOU ARE NOW READY FOR WORKSHOP 
#3 
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TOPIC VII 


THE COMMAND LANGUAGE 


What is a Command . 7-1 
Command Arguments . ... 2. e's © © © e © we ew we ww ew ew ew) TH 
Common Control Arguments . .. 2. 2. 6 © 6 ee we ew we we) 7H6 
Star CONVENtION «. & 4 aoe Ge ae. Se we a a we We, TeT 
Subsystems .... «se se.vree T-1 
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WHAT IS A COMMAND 


@ COMMAND PROCEDURE 


1 A PROGRAM - USUALLY WRITTEN BY A SYSTEMS PROGRAMMER 
i> RESIDES IN ONE OF THE SYSTEM'S LIBRARIES 
] EXECUTED BY TYPING ITS NAME 


J DESIGNED TO 
Q PERFORM EXPECTED TASK 
ACCEPT AN ARBITRARY NUMBER OF ARGUMENTS 
) REPORT TYPING ERRORS 


1 HANDLE OTHER USER ERRORS 


WHAT IS A COMMAND 


COMMAND 


f THE CHARACTER STRING TYPED AT THE TERMINAL TO INVOKE A SPECIFIC 
COMMAND PROCEDURE | 


_ [> EXAMPLES: 


1 THE COMMAND PROCEDURE accept_messages IS INVOKED BY TYPING 
THE COMMANDS: 


accept_messages 


am 


) THE COMMAND PROCEDURE print IS INVOKED BY TYPING THE 
COMMANDS: © a 


print seg_1 


pr treasure hunt 


T-2 | FO 1 


WHAT IS A COMMAND 


COMMAND LINE 


] A LINE TYPED AT THE TERMINAL WHEN AT MULTICS COMMAND LEVEL 


l MAY BE ONE COMMAND 
accept_messages 
am 


print seg 1 


1 MAY BE A MISTYPED COMMAND 


primt seg 1 


l MAY BE MORE THAN ONE COMMAND SEPARATED BY SEMI-COLONS 
accept messages; pr seg 1 
am; print start _up.ec; who 


‘ 


i 


1 MAY BE NULL (I.E., JUST A LINEFEED) Lew 


l FREE FORMAT ACCEPTED (EXTRA SPACES ARE IGNORED) 
list -all; sm  Ldones.FED —‘TECO is ready! 
print add.pl1 
am;pm;who 


am ;pm; who.  ;3; 
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COMMAND ARGUMENTS 


ARGUMENTS 


J A SERIES OF CHARACTER STRINGS THAT FOLLOW A COMMAND 


PATHNAME ARGUMENTS 


1 THE NAMES OF SEGMENTS OR DIRECTORIES UPON WHICH THE COMMAND IS 
TO ACT 


ewd >udd>FO1>Student_ 01 


print seg_1 


CONTROL ARGUMENTS 


I ARGUMENTS THAT MODIFY THE MANNER IN WHICH THE COMMAND PERFORMS 
ITS TASK 


l ALWAYS START WITH A ~- (MINUS) 
list -segment 
list -directory 
list -all 


list seg _1 -date time_used 
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COMMAND ARGUMENTS 


ARGUMENTS OF CONTROL ARGUMENTS 
dprint -copy 2 -ds MS_102 add.pl1 
dp -cp 2 -ds ‘"MS 102" add.plt 
set tty -modes crecho 


memo -time 8am WAKE UP! 


OTHER ARGUMENTS 
sm Student _04.F01 Going to lunch? 
print seg 2 15 40 


login TSmith 


NO ARGUMENTS 
i” a 


defer_messages 


DEFAULT ARGUMENTS (HURRAH FOR DEFAULTS!) 


reenter nt ee 


— | 
(jy ~change_wdir {Home Directory} 
pod | 


/ print seg 2 {first last} 
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LONG FORM 


-all 


-brief 
-copy n 
-~directory 
ene 
-optimize 


-print 


-queue n 
-segment 
-table 
-time {dt} 


-totals 


SHORT FORM 


-a 


-tb 


-tm {dt} 


att 


COMMON CONTROL ARGUMENTS 


USUAL MEANING 


OPERATE ON ALL TYPES OR ALL ENTRIES 


SHORTEN THE VERBOSITY AND/OR 
CONTENTS OF RESPONSE | 
CREATE n COPIES 

OPERATE ON DIRECTORIES 

INCREASE THE VERBOSITY AND/OR 


CONTENTS OF RESPONSE 
OPTIMIZE 


COMDTI grec 
wWwinsd é 


de bd hs AI 


GENERATED CODE (FOR 


PRINT A STATUS OR SUMMARY REPORT 
USE PRIORITY QUEUE n 

OPERATE ON SEGMENTS, OR SEND OUTPUT 
TO A SEGMENT 


GENERATE A 
COMPILERS) 


SYMBOL TABLE (FOR 


DELAY UNTIL THE SPECIFIED TIME, OR © 
GENERATE TIMING STATISTICS 


PRINT TOTALS 
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‘STAR CONVENTION 


@ STAR CONVENTION 


~Aimeucsesarnamseaoomra 


f A SHORTHAND NOTATION ACCEPTED BY MANY COMMANDS USED TO SPECIFY 
A GROUP OF SEGMENTS OR DIRECTORIES 


1 * MATCHES ANY SINGLE COMPONENT OF AN ENTRYNAME 
fe 


1 *#* MATCHES a aia OF COMPONENTS IN AN ENTRYNAME 


q 2 MATCHES ANY CHARACTER IN A COMPONENT OF AN ENTRYNAME 


@ ASSUME SOME DIRECTORY CONTAINS THE FOLLOWING SEGMENTS: 


a.fortran seg_1.pl11 
ad.fortran seg _1.new 

add | seg _1.new.cobol 
add.pl1 seg 1.old 

new seg 1.o0ld.pl1 
new.a.fortran seg_1.old.test.pl1 


@ EXAMPLES USING THE list COMMAND (THE list HEADER IS NOT SHOWN) 


list seg_1.pl1 seg_1.new seg _1.old 


rw 1 seg_1.pli 
rw 2 seg _1.new 
rw 1 seg_1.old 
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STAR CONVENTION 


list seg 1.* 


rw 1 seg_1.pl1 
rw 2 seg. ~1.new 


rw 1 seg _1.0ld 


list seg _1.*.* 


rw 1 seg 1. new.cobol 
rw 2 seg 1.0ld.pl1 
yf 
( 

list new.#* © \“—— 

rw 1 new 

rw | new.a.fortran 
list *.pli1 

rw 1 add.pli 

rw 1 seg_1.pl1 


list **.pli 


rw ij add.pli 

rw 1 seg _1.pl1 

rw 2 seg_i.old.plt 

rw 1 seg_1.old.test.pl1 
list eH 

rw 1 seg _1.0ld.test.pl1 

et einen OO if ws wet had ae T 

list a*t - —----— jeer Lo akaret! 

rw 1 add eG 
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STAR CONVENTION 


list s#®.#*.p11 
rw 2 seg_1.old.plt 


list s#¥,## ,p# 


rw 1 seg_1.pl1 


rw 2 seg _1.old.pl1 

rw 1 seg_1.old.test.pli 
list 2??? 

rw 1 add 

rw 1 new 
list a?.# 

rw 1 ad.fortran 


SE SE I NT ELIS 
list a?*.# 


rw - 1 +ad.fortran 
rw 1 add.pli 


list ad*,#*# 


rw 1 add 

rw 1 add.pli 

rw 1 ad.fortran 
list ** 


<all segments> 
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SUBSYSTEMS 


SUBSYSTEM 


A COLLECTION OF PROGRAMS THAT PROVIDE A SPECIAL ENVIRONMENT ‘FOR 
SOME PARTICULAR PURPOSE 


1 EDITING 
edm 


qedx 


0 CALCULATION 


1 DEBUGGING 


A USER ENTERS A SUBSYSTEM BY COMMAND AND EXITS THE SUBSYSTEM BY 
REQUEST 


TYPED LINES ARE INTERPRETED BY THE SUBSYSTEM, NOT BY THE 
MULTICS COMMAND PROCESSOR; THEREFORE, THEY ARE NOT COMMAND 
LINES 


THE SUBSYSTEM MAY PERFORM ITS OWN REQUEST PROCESSING, FILE 
HANDLING, AND ACCOUNTING 


SUBSYSTEMS | 
@ REQUEST LINE FLOW 
TYPED LINE 
FRONT-END PROCESSOR 


SUBSYSTEM 


EXECUTION 


@ COMMAND. LEVEL 


f THE PROCESS STATE IN WHICH TYPED LINES ARE INTERPRETED BY THE 
MULTICS COMMAND PROCESSOR 


] TYPED LINES ARE REFERRED TO AS COMMAND LINES 


@® SUBSYSTEM LEVEL 


] THE PROCESS STATE IN WHICH TYPED LINES ARE INTERPRETED BY THE 
SUBSYSTEM | 


] TYPED LINES ARE REFERRED TO AS REQUEST LINES 
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What is an Exec com . 


Exec com Mechanism 
Start_up Exec_coms_ 


TOPIC VIII 


EXEC_COM BASICS | 


FO1 


This page has intentionally 
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et mae 8 aS 


WHAT IS AN EXEC COM 


@ EXEC COM 
1 A SEGMENT THAT CONTAINS A SERIES OF COMMAND LINES 
1 MAY BE CREATED USING A TEXT EDITOR 
I SEGMENT NAME MUST HAVE A SUFFIX OF ec. 
A.ec 
print.ec 


Start _up.ec 


0 THE COMMAND LINES ARE EXECUTED SEQUENTIALLY, AS A SET, BY USING 
THE exec_com COMMAND 
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EXEC COM MECHANISM 


oo bi anew 


@ exec fom, ec / 
wee 
——— 


Priam eeea REVIT? 


0) EXECUTES THE COMMAND LINES CONTAINED IN AN EXEC _COM SEGMENT 


1 COMMAND LINES ARE PRINTED ON THE USER'S TERMINAL AS THEY ARE 
EXECUTED | 


] USAGE: exec com path 
ec A.ec 


ec print.ec | 


ec start_up.ec 


@ EXEC COM LINE FLOW 


EXEC COM LINES 
COMMAND PROCESSOR 


EXECUTION 
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EXEC COM MECHANISM 


EXAMPLE: LET THE SEGMENT print.ec CONTAIN THE FOLLOWING TEXT: 


print.ec 


ewd >udd>F01>Student_07 
ls : 

pr seg 1 

logout 


1 TYPING THE ONE COMMAND 
ec print.ec 


HAS THE SAME EFFECT AS TYPING THE FOUR COMMANDS ABOVE 
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START UP EXEC COMS 


@ START_UP EXEC_COM 
] HAS THE NAME start_up.ec 
) LOCATED IN USER'S HOME DIRECTORY 


THE COMMAND LINES CONTAINED WITHIN ARE AUTOMATICALLY EXECUTED 
FOR THE USER AT LOGIN 


1 CAN ALSO BE INVOKED MANUALLY 


ec start_up.ec 


AK SET-UP USER'S ENVIRONMENT 
PA | 


j 
f 


] CHECK ON EVENTS SINCE LAST LOGIN 


] PERFORM ANY DESIRED TASKS AT LOGIN 
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START UP EXEC COS 


EXAMPLE: LET THE SEGMENT start _up.ec CONTAIN THE FOLLOWING TEXT: 


start_up.ec 


\ 


0 THESE TWO COMMANDS ARE AUTOMATICALLY EXECUTED FOR THE USER AT 
LOGIN 


NOTE: THE PRESENCE OF A start up.ec. WILL SUPPRESS THE PRINTING OF 
THE SYSTEM'S MESSAGE OF THE DAY AT LOG IN 
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START UP EXEC COMS 


print _motd, pmotd 

0 PRINTS OUT THE MESSAGE OF THE DAY IF THE USER HASN'T ee 

] CREATES AND USES A HOME DIRECTORY SEGMENT NAMED person id.motd 
0 THIS COMMAND IS NORMALLY FOUND IN USER'S start _up.ec 


0 USAGE: print_motd 


nmata 
weeew ww 
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TOPIC IX 


THE ABBREV PROCESSOR 


Page 
What is the Abbrev Processor... ‘ ; , ‘Q=1 
Abbrev Mechanism .....-e «6s ee : ir Q-2 
Abbrev Requests e ° e ® e e 6 ° e ° e e e g-4 
e e e r) e -e e e e 9-8 


Abbrev Examples ..... . 


Jai FO1 
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WHAT IS THE ABBREV PROCESSOR 


cen GEE renee = tbe ciettemeraeinesiateeets 


@® ABBREV PROCESSOR 


1 A FACILITY ALLOWING USERS TO ABBREVIATE PARTS OF (OR WHOLE) 
COMMAND LINES | 


1 A SUBSYSTEM WHICH MUST BE EXPLICITLY INVOKED BY THE USER 
(ABBREV MODE) | 


] FUNCTIONS 
1 RESPOND TO ABBREV REQUEST LINES 


q EXPAND ABBREVIATIONS IMBEDDED IN COMMAND LINES 
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ABBREV MECHANISM — 


Ps fo 
be a 

5 

H 

fo 


@ abbrev, ab ~~ 
—, 


0 PLACES THE USER IN ABBREV MODE. (INVOKES THE ABBREV PROCESSOR) 


1 USAGE: abbrev 
ab 


@ COMMAND LINE FLOW 


TYPED LINE 


FRONT-END PROCESSOR 


LL 
{ABBREV ee aa 


COMMAND PROCESSOR 


EXECUTION 
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ABBREV MECHANISM 


ABBREV MECHANISM 


1 ABBREV PROCESSOR EXAMINES TYPED COMMAND LINES 


] ABBREV REQUEST LINES 
| BEGIN WITH "." 
‘(| DEFINE, DELETE, LIST ABBREVIATIONS 
I CONTROL OTHER ABBREV OPERATIONS 


1 COMMAND LINES 
1 DO NOT BEGIN WITH "." 


f ANY AND ALL PREVIOUSLY perNer ABBREVIATIONS FOUND ARE 
EXPANDED 


1 COMMAND LINE IS THEN PASSED ON TO THE COMMAND PROCESSOR 


MAINTAINED IN A HOME DIRECTORY SEGMENT NAMED 


q ULATIONS 


eae id. profile 
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ABBREV REQUESTS 


EOE g¥) 
eS 2 : 
( tee 
-“") ADD AN ABBREVIATION TO THE USER'S PROFILE SEGMENT 
I ABBREVIATIONS MUST BE 8 CHARACTERS OR LESS 
l USAGE: .a abbrev meahing-of-abbreviation 
.a F1 >udd>F01 
va LARRY LuJones.FED 
go 
fe ab 
eo 


0 DD AN ABBREVIATION WHICH IS VALID ONLY AT THE BEGINNING OF A 
COMMAND 


J USAGE: .ab abbrev meaning-of-abbreviation 
-ab dp dprint -he T.Smith -ds Stat 14 
-ab cata list 


-ab GO ec run_it.ec 
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ABBREV REQUESTS 


: de 
ae a 
) DELETE SPECIFIED ABBREVIATION(S) FROM THE USER'S PROFILE 
J USAGE: .d abbrevi...abbrevn 
-d LARRY 
: s 
# / 
LIST CURRENTLY DEFINED ABBREVIATIONS AND WHAT THEY STAND FOR 
l USAGE: .1 {abbrev1...abbrevn} 
1 
-l F1 dp 
ola 


ome 


LIST ABBREVIATIONS THAT BEGIN WITH THE SPECIFIED LETTER(S) 
) USAGE: .la letteri...lettern 


elamd 
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ABBREV REQUESTS 


e ZZ 
Pd 2 QUIT USING THE ABBREV PROCESSOR 


AM 
I USAGE: .q 


{| EXPAND AND SHOW THE COMMAND LINE WITHOUT EXECUTING IT 


1 USAGE: .s text 
-S cwd F1; dp add.plt- 


9-6 Ss FQ} 


[mj 


ABBREV REQUESTS 


EXECUTE THE COMMAND LINE WITHOUT EXPANDING IT 


USAGE 1: . text 
(DON'T EXPAND) 
: . print A.lunch.cb 


USAGE 2: 
( ACKNOWLEDGE) 


ACKNOWLEDGE THAT THE USER IS IN ABBREV MODE (ABBREV RESPONDS 
WITH "ab") | 


OFTEN USED TO AFFIRM COMMAND LEVEL WHEN "MULTING" WITH THE 
READY MESSAGE OFF 
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ABBREV EXAMPLES 


@ LET TSmith's PROFILE SEGMENT CONTAIN THE FOLLOWING ABBREVIATIONS 


LJones.FED 


>udd>ProjA>TSmith 

>udd>FO1 | 

sm LJones.FED Lunch time! 
dprint -he TSMITH -ds Stat_14 


@ EXAMPLES OF COMMAND LINE EXPANSION (IF IN ABBREV MODE) 


print array dot.ft 
print array dot.fortran 


sm LARRY Where's your dims program? 
sm LJones.FED Where's your dims program? 


ewd Fi>Student_01 
ewd >udd>FO1>Student 01 


dp add.pli 
dprint +-he TSmith -ds Stat _14 add.pl1 


list dp.ft 
list dp.fortran 


lunch 
sm LJones.FED Lunch time! 
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ABBREV EXAMPLES 


print A.lunch.eb _ 
print A.sm LJones.FED Lunch time! .cobol 


- print A.iunch.cb 
print A.lunch.cb 


- print A.lunch.cobol 
print A.lunch.cobol 


print clunch.cb 
print clunch.cobol 


print A_lunch.pl1 
print A_lunch.pl1 


@ CANDIDATES FOR EXPANSION MUST BE 
> PART OF COMMAND LINE (MAY BE THE ENTIRE COMMAND LINE) 


l CHARACTER STRING, 8 CHARACTERS OR LESS, THAT ARE 


1 BOUNDED BY BREAK CHARACTERS 


tab a | 


w 


newline 


space 
ft 


$ 


we Own Be «6 
at oe I AY 


NOTE: — : AND ? ARE NOT A BREAK CHARACTERS! 
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ABBREV EXAMPLES 


YOU ARE NOW READY FOR WORKSHOP 
#4 
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What is Programming . 


Developing a Source Program ‘ 
Compiling a Source Program 


PROGRAMMING ON MULTICS 


e 


TOPIC X 


Entrynames and Entry Point Names 
Executing an Object Program . 


Debugging Tools. . 
Dynamic Searching . 


e 


10-1 


e 


e e. J 


Page 
10-1 
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- 10-11 


10-13 
10-18 
10-21 
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WHAT IS PROGRAMMING 


@ PROGRAM 


n 


i A LOGICAL SEQUENCE OF OPERATIONS TO BE PERFORMED BY A COMPUTER 


{ SOURCE PROGRAM 
1 WRITTEN IN AN ENGLISH-LIKE PROGRAMMING LANGUAGE 
] CREATED BY A USER VIA A TEXT EDITOR 
' KEPT IN A SEGMENT CALLED THE SOURCE SEGMENT 


] CANNOT BE EXECUTED 


] OBJECT PROGRAM 
f WRITTEN IN BINARY MACHINE LANGUAGE 


1 CREATED BY A COMPILER (WHICH IS ALSO AN OBJECT PROGRAM) FROM 
THE SOURCE PROGRAM 


I. KEPT IN A SEGMENT CALLED THE OBJECT SEGMENT 


] EXECUTED BY TYPING ITS NAME 
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WHAT IS PROGRAMMING 


PROGRAMMING LANGUAGES SUPPORTED BY MULTICS(1) 


“ott pis (VERSATILE, BLOCK STRUCTURE, DYNAMIC ALLOCATION, 
“RECURSIVE, MANY DATA TYPES) 


/ 
1 FORTRAN (SCIENTIFIC COMPUTATIONS) 77 
a eet 


ee 


1 COBOL (BUSINESS APPLICATIONS, VERBOSE, WIDELY USED) 
J BASIC (COMPUTATIONS, EASY TO LEARN, LIMITED DATA TYPES) 
1 APL (DATA MANIPULATION, CRYPTIC BUT POWERFUL) 


l ALM (MULTICS ASSEMBLER LANGUAGE - YES! WE HAVE AN ASSEMBLER ) 


@ THERE EXISTS A SYSTEM PROGRAM, CALLED A COMPILER, FOR EACH 
PROGRAMMING LANGUAGE SUPPORTED. COMPILERS ARE DESIGNED TO 
TRANSLATE A PARTICULAR PROGRAMMING LANGUAGE INTO MACHINE LANGUAGE 


(1) RELATED MULTICS COURSES: APL (G11 & F11), BASIC (F127), COBOL-74 
(F13), FORTRAN (F114), PL/I (F15, F15C, F15D). 
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WHAT IS PROGRAMMING 


PROGRAMMING 


1 DEVELOPING THE SOURCE PROGRAM IN THE PROGRAMMING LANGUAGE OF 
CHOICE 


1 COMPILING (TRANSLATING) THE SOURCE PROGRAM (SOURCE SEGMENT) 
INTO AN OBJECT PROGRAM (OBJECT SEGMENT 


1 EXECUTING THE OBJECT PROGRAM USING TEST DATA — 
1 DEBUGGING THE SOURCE PROGRAM TO CORRECT ALL OBSERVED PROBLEMS 
| MAKING THE OBJECT PROGRAM AVAILABLE> 


l SYSTEM PROGRAMS MUST BE "INSTALLED" IN ONE OF THE SYSTEM 
LIBRARIES 


] USER PROGRAMS NEED NO FURTHER ACTION EXCEPT THE SETTING OF 
ACCESS TO ALLOW USE BY OTHER USERS | | 
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DEVELOPING A SOURCE PROGRAM 


DESIGNING (OUTLINING) A SOURCE PROGRAM 


1 TOP-DOWN DESIGN 
l MODULAR DESIGN 


] FLOWCHARTING 


1 INTERNAL DOCUMENTATION (STEP BY 


PROGRAM) 


1 "SELF-DOCUMENTING" LANGUAGES 


WRITING (CODING) THE SOURCE PROGRAM. 


PROGRAMMING LANGUAGE 


1 "GO-TO-LESS" PROGRAMMING 


] MNEMONIC VARIABLE NAMES 


10-4 


] EXTERNAL DOCUMENTATION (PURPOSE, GENERAL DESIGN, HOW TO USE) 


STEP DESCRIPTION OF THE 


(USUALLY ON PAPER) IN SOME 


FOQ1 


DEVELOPING A SOURCE PROGRAM 


I ERROR DETECTION AND HANDLING 


@ INPUTTING THE SOURCE PROGRAM, VIA A TEXT EDITOR, TO A SOURCE 
SEGMENT 


1 A SOURCE SEGMENT MAY BE GIVEN ANY DESIRED NAME, HOWEVER, THE 
SUFFIX MUST BE THE ENTRYNAME OF THE PROGRAMMING LANGUAGE USED 


add.pli1 ran_num_ gen.basic 
A_alpha.cobol page fault.alm 


array dot.fortran 


OPTIONALLY FORMATTING THE SOURCE PROGRAM (COSMETICS) 


1 SEVERAL COMMANDS EXIST FOR THE PURPOSE OF FORMATTING SOURCE 
PROGRAMS 


1 DONE TO IMPROVE THE READABILITY OF A SOURCE PROGRAM 


1 THE COMMANDS DETECT AND REPORT CERTAIN TYPES OF SYNTAX ERRORS, 
AND ARE OFTEN USED AS A PRE-COMPILE EXAMINATION 
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DEVELOPING A SOURCE PROGRAM 


J indent, ind 
1 IMPROVES THE READABILITY OF A PL/1 SOURCE SEGMENT 


l USAGE: indent pathi {path2} {control_arg} 
ind add.pl1 add.ind.plt 
ind add.plt1 
ind >udd>F01>Student_09>add.pl1 -indent 3 
1 format_cobol_ source, fes 


1 CONVERTS FREE-FORM COBOL SOURCE PROGRAMS TO FIXED-FORMAT 


J USAGE: format_cobol_source path1 path2 


fes A_alpha.cobol A_alpha.fes.cobol 
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COMPILING A SOURCE PROGRAM 


@® COMPILER: 


1 A SYSTEM PROGRAM DESIGNED TO TRANSLATE A PARTICULAR PROGRAMMING 
LANGUAGE (ENGLISH-LIKE) INTO MACHINE LANGUAGE (BINARY) 


Ht COMPILE COMMANDS (CREATE OBJECT PROGRAM AND OBJECT SEGMENT!) 


1 USAGE: language name path {-control args} 
pll add.plt 
pl1 >udd>F01>Student_09>add.p11 
eobol A_alpha.cobol 
fortran array dot.fortran 
basic ran_num_gen.basic 


alm page fault.alm 


@ OBJECT PROGRAMS 


] ALL OBJECT PROGRAMS PRODUCED BY MULTICS COMPILERS ARE: 


1 PURE (DO NOT MODIFY THEIR OWN CODE) 


Pmmeeue nie wine 


— 


l RE-ENTRANT (MORE THAN ONE USER MAY EXECUTE THE SAME CODE) 
ee Ere Fore - > 


l RECURSIVE (A PROGRAM CAN CALL ITSELF). 


f IN STANDARD FORMAT (OBJECTS GENERATED FROM DIFFERENT 
LANGUAGES MAY CALL EACH OTHER EASILY) ; = 
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COMPILING A SOURCE PROGRAM 


THE OBJECT PROGRAM IS PLACED IN A SEGMENT (CALLED THE OBJECT 
SEGMENT) IN THE USER'S WORKING DIRECTORY 


THE OBJECT SEGMENT IS GIVEN THE CORRESPONDING SOURCE SEGMENT'S 
ENTRYNAME WITH THE SUFFIX REMOVED 


add : ran_num_gen 
A_alpha | page fault 
array dot 


SOME CONTROL ARGUMENTS WILL CAUSE A COMPILER TO PRODUCE A 
COMPILER LISTING OPTIONALLY CONSISTING OF A LINE-NUMBERED 


SOURCE LISTING, A SYMBOL TABLE, AN OBJECT CODE MAP, ERROR 
MESSAGES, ETC. 


THE COMPILER LISTING IS PLACED IN A SEGMENT (CALLED THE LIST 
SEGMENT) IN THE USER'S WORKING DIRECTORY 


THE LIST SEGMENT IS GIVEN THE CORRESPONDING SOURCE SEGMENT'S 
NAME WITH THE ORIGINAL SUFFIX REPLACED BY THE SUFFIX list 


add.list ran_num_gen.list 


A_alpha.list page fault.list 
array dot.list 


10-8 | | FQ1 


COMPILING A SOURCE PROGRAM 


DIAGNOSTICS 


1 COMPILERS WILL COMPLAIN ABOUT: 
-]) SYNTAX ERRORS 
1 MISSPELLINGS 


0 UNDEFINED REFERENCES 
1 ERROR MESSAGES ARE PRINTED AT THE USER'S TERMINAL 


I SEVERE ERRORS WILL SUPPRESS THE FORMATION OF THE OBJECT PROGRAM 
AND OBJECT SEGMENT 


J THE FORMAT OF ERROR MESSAGES IS COMPILER-DEPENDENT. THE 
FOLLOWING IS A PL/I ERROR MESSAGE: 


ERROR 158, SEVERITY 2 ON LINE 30 
A constant immediately follows the identifier "zilch" 
SOURCE: a = zilch 4; 
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COMPILING A SOURCE PROGRAM 


RM A 
/.N 


| DEVELOPED 
INTO 


SOURCE 


PROGRAM 


WRITTEN 
(VIA EDITOR) 


SOURCE 
SEGMENT 
(add.pl1) 


OPTIONALLY 
OBJECT PRODUCES COMPILER PRODUCES SOURCE 
PROGRAM | SC (A PROGRAM) LISTING 
WRITTEN | WRITTEN 
(BY COMPILER) (BY COMPILER) 


INTO INTO 


OBJECT LIST 


SEGMENT 


SEGMENT 
(add) 


(add.list) 
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-ENTRYNAMES AND ENTRY POINT NAMES 


o_O 0 en eee 


@ ENTRYNAME ( 
a} 


1 <A NAME GIVEN TO AN ITEM CONTAINED IN A DIRECTORY 


Cagnnte proper 


ye ENTRY POINT NAME 


1 THE NAME ASSOCIATED WITH AN ENTRY POINT IN AN OBJECT SEGMENT 
. | et nae a pap prereset eg pT ene Sn Oe et 


® UNLESS OTHERWISE SPECIFIED, MULTICS ASSUMES THE ENTRY POINT NAME 
IS THE SAME AS THE ENTRYNAME 


- | ppourwe C308 
(MAW 2 S16poT INE C 


gatry 
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gee ace ETTORE oe ER SNA eg 
= pert RRNA IE 


_ ——- me 
LENTRYNAMES AND ENTRY POINT NAMES » 
eee 


$ (DOLLAR SIGN) 


Se 


] SEPARATES THE ENTRYNAME OF AN OBJECT SEGMENT FROM THE ENTRY 
POINT NAME WITHIN THE OBJECT SEGMENT 


I EXAMPLE USING AN OBJECT SEGMENT add HAVING ENTRY POINTS add AND 


max | | 
INVOKED INTERPRETED ENTRY 
AS AS POINT 
add add$add add 
add}max add$max max 
max max$max it 


0 EXAMPLE AS ABOVE WITH ALIAS NAME max ADDED TO THE SEGMENT 


INVOKED INTERPRETED ENTRY 
AS AS . POINT | 
add: 
ee add add$add add 
add$max add$max max 
max max$max max 
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EXECUTING AN OBJECT PROGRAM 


AN OBJECT PROGRAM (OBJECT SEGMENT) IS EXECUTED BY TYPING ITS NAME 
AT A TERMINAL 


add , ran_num_gen 
A_alpha page fault 


array dot - >udd>FO1>Student_09>add 


POSSIBLE RESULTS OF EXECUTING A PROGRAM 


J PROGRAM RUNS TO NORMAL TERMINATION & USER RECEIVES READY 
MESSAGE 


] PROGRAM PAUSES FOR INPUT FROM THE USER'S TERMINAL 


1 PROGRAM HALTS BECAUSE OF A —-USER-IMPLANTED BREAKPOINT (A 
DEBUGGING TOOL) 


1 PROGRAM HALTS BECAUSE OF A FATAL EXECUTION ERROR 
asthe Soe 


J OVERFLOW UNDERFLOW, DATA CONVERSION ERROR, . UNDEFINED 
REFERENCE 


1 HALTS (INTERRUPTS) THE EXECUTION OF A PROGRAM OR COMMAND. 
(FROZEN IN MID-AIR) 


1 RESPONDS WITH A READY MESSAGE CONTAINING A _ level CLAUSE CLAUSE 


. T1038, 5 0.185 0.012 27 are. 
ON fe at 
yey 
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EXECUTING AN OBJECT PROGRAM 


pnb 4D 
Yor / 


PROGRAM ISSUED A QUIT SIGNAL 


TERMINAL KEY LABELED ATTN, BRK, INTRPT, INTERRUPT,... 


HALTS (INTERRUPTS) THE EXECUTION OF A PROGRAM OR COMMAND. 
(FROZEN IN MID-AIR) 


RESPONDS WITH A READY MESSAGE CONTAINING A level CLAUSE 
r 1038.5 0.185 0.012 27 level 2,11 
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EXECUTING AN OBJECT PROGRAM 
THE USER'S STACK (A HISTORY OF CURRENT EVENTS) 


————————— User logs in. 


1 user.init.admin —$ user_init_admin— 
; —q——————— Given default overseer. 


2 process _ overseer_$ process_overseer— 


Receives ready message. 
User types “‘add”’. 


3 listen_$ listen . level 1,3 
<@-———-—- Abbrev processor called. 


4  abbrev_ $ abbrev_ 


5 command_processor_$ command_processor 
mi se a] Command line 


is interpreted. 


6 command_oprocessor_$ read_list 
Program “add” 


begins execution. 


7 add $ add 
“add” requests ' : 
terminal read ; 
and then ot AC | 8  tty_$ tty_get_line 
User hits ‘‘break”’. 
| 9  ipce_$ block quit 

System. ! . 

recovers | -10 return_to_ring_O_$ return_to_ring_0_ 

from “Break”. . 

| 11 default_error_handler_$ wall 
User raceives| | 12 get_to—cl_$ unclaimed_signal 


Hevel 2, 14 — emmnnnnge 


ready message. 13 listen_$ release_stack level 2, 13 
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EXECUTING AN OBJECT PROGRAM 


POSSIBLE USER ACTIONS AFTER A QUIT SIGNAL OR FATAL ERROR 
1 IGNORE THE OLD LEVEL(S) AND PROCEED (EXPENSIVE) 


2 OBSERVE WHAT WAS HAPPENING USING DEBUGGING TOOLS 
value k 


value qty_on_hand 


0 CHANGE VALUES OF VARIABLES USING DEBUGGING TOOLS 


3k 2 
LOU K=4 


let qty_on_hand = 0 


[ start, sr_— 


J RESTARTS THE PROGRAM OF THE IMMEDIATELY PREVIOUS LEVEL AT 
THE INTERRUPT POINT 


jf USAGE: start 


1 EXAMPLE: WHILE IN qedx, THE USER SIGNALS QUIT WHILE DOING A 
1,$p. AFTER RECEIVING A READY MESSAGE THE USER TYPES start, 
AND THE 1,$p CONTINUES 
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EXECUTING AN OBJECT PROGRAM 


] program interrupt, pi 
ll RESTARTS THE PROGRAM AT A PROGRAMMER DETERMINED POINT 


1 PROGRAM MUST HAVE BEEN WRITTEN WITH A program interrupt 
HANDLER 
USAGE: program_interrupt 
pi 
l EXAMPLE: WHILE IN qedx, TRE USER SIGNALS QUIT WHILE DOING A 


1,$p. AFTER RECEIVING A READY MESSAGE THE USER TYPES pi, 
AND FINDS HIMSELF BACK IN THE EDITOR AT REQUEST LEVEL 


1 release, rl 
ee eeteeree 
ea 


1 RELEASES THE IMMEDIATELY PREVIOUS LEVEL(S) (ONE OR ALL) 


USAGE: release {-control_ arg} 
rl | 
rl -all 
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DEBUGGING TOOLS 


DEBUGGING TOOLS 


l SUBSYSTEMS WHICH ARE USEFUL IN LOCATING, EXAMINING, AND 
CORRECTING UNEXPECTED OCCURRENCES OR CONDITIONS WITHIN OBJECT 
PROGRAMS 


1 SUCH TOOLS MINIMIZE THE NEED FOR MEMORY DUMPS 


debug, db 
1 INVOKES AN INTERACTIVE DEBUGGING AID 
HARDWARE LEVEL, SYMBOLIC, CRYPTIC 


] PROCEDURES MAY HAVE ORIGINATED FROM ANY LANGUAGE. (SYMBOLIC 
CAPABILITY ONLY AVAILABLE FOR PL/I AND FORTRAN) 


f IN ORDER TO UTILIZE SYMBOLIC CAPABILITIES, THE SOURCE PROGRAM 
MUST HAVE BEEN COMPILED WITH THE -table CONTROL ARGUMENT 


l USES A HOME DIRECTORY SEGMENT NAMED Person_id.breaks 


0 USAGE: debug 
db 
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DEBUGGING TOOLS 


probe, pb 


0 


INVOKES AN INTERACTIVE DEBUGGING AID 
SYMBOLIC, SOURCE LEVEL 


PROCEDURES MUST HAVE ORIGINATED FROM PL/I, FORTRAN, OR COBOL 
SOURCE 


IN ORDER TO UTILIZE SYMBOLIC CAPABILITIES, THE SOURCE PROGRAM 
MUST HAVE BEEN COMPILED WITH THE -table CONTROL ARGUMENT 


USAGE 1: probe path 
(SETTING) 


USAGE 2: probe 
(EXAMINING) 


A THOROUGH DISCUSSION OF THE probe COMMAND MAY BE FOUND IN THE 


COMMANDS AND ACTIVE FUNCTIONS MANUAL AG92 
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DEBUGGING TOOLS 


DEBUG 
CAPABILITIES 
EXAMINE DATA, SOURCE AND OBJECT 
MODIFY DATA AND OBJECT 
EXECUTE COMMANDS 
CONDITIONAL BREAK POINTS 


EXAMINE MACHINE CONDITIONS 


EXAMINE REGISTERS 
DUMP DATA IN VARIOUS FORMATS 
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PROBE 


CAPABILITIES 


ee ant we 


EXAMINE DATA AND SOURCE 
MODIFY DATA 
EXECUTE COMMANDS 


CONDITIONAL BREAK POINTS 
AND/OR OPERATIONS © 


RECALL: 


| COMMAND PROCEDURE 


0 A PROGRAM INVOKED BY TYPING ITS NAME 


OBJECT PROGRAM 


1 EXECUTED BY TYPING ITS NAME 


COMMAND LINE INTERPRETATION 


l THE FIRST WORD OF EVERY COMMAND IS ASSUMED TO BE THE NAME OF AN 
OBJECT PROGRAM 


list -all 
ls 
send message Student _05.F01 Where are you? 


add» 


0 MULTICS SEARCHES THROUGH VARIOUS (PREDETERMINED) DIRECTORIES TO 
FIND AN OBJECT SEGMENT HAVING THE SPECIFIED NAME 


1 IF THE SEARCHING IS SUCCESSFUL, LINKING OCCURS ("THE LINK IS 
SNAPPED") AND EXECUTION COMMENCES 
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DYNAMIC SEARCHING 


é 


ALL COMMANDS (SYSTEM PROGRAMS), USER-WRITTEN PROGRAMS, AND 
SUBROUTINE MUST BE "FOUND" BEFORE THEY CAN BE EXECUTED 


& f 
“ ; 
‘4 
ke, 


Nee ha as OX, 
“SEARCH RULES (WHERE, O'WHERE) 


A LIST SPECIFYING THE NAMES AND THE ORDER OF DIRECTORIES TO BE 
SEARCHED 


SEARCH RULES ONLY HAVE SIGNIFICANCE FOR THE EXECUTION OF OBJECT 
PROGRAMS. COMMANDS SUCH AS list AND print DO NOT SEARCH FOR 


eee re soma SR MAN erm a8 


\ 
< 
AYN DEFAULT SEARCH RULES 


cans a NA PA AAR eS eee 


=: initiated segments 
-referencing directory 
_ working directory 


>system library standard 
>system_ library unbundled 
>system library 1 

>system library tools 
>system_ library auth maint 
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€2-Ol 


LOd 


SEARCH RULES EXAMPLE FOR USER JONES 


« working 
directory 


Jones’ TERMINAL INPUT 


SEGMENTS FOUND 
SEGMENT INITIATED 


COMMAND LINE TYPED 


|| REFERENCE 
NAME oes 


login Jones ( login RELATED bY - 

' SEGMENTS Bers Coe RELATED 
password | SEGMENTS 
pwd > $$$ > pwd 


> $ss > pwd 

>udd >... >Jones >$ 
>udd>...>Jones >T 
>udd>...>Smith > XYZ 
>udd> ...>Smith>R 


...> Jones > 
> udd>...>Jones >T 
>udd>...>Smith > XYZ 
>udd>...>Smith>R 


> udd >... >Smith >XxYZ 


xXxv2 .. >Smith > XYZ : 
.. >Smith >R >udd> ...>Jones > ABC 
ABC . >Jones > ABC > $$s > pr 


..>Smith>R 
> $s$ > pr 
> sss > pr 


pr >udd>...> Smith > R.pt1 
pr R.pl1 


eee 


DNIHOUVES DINWNid 


DYNAMIC SEARCHING 


Sf ® print search rules, psr wh fot Lf tO 


omnes ann 


0 PRINTS THE USER'S CURRENT SEARCH RULES 


J USAGE: print search rules 


psr 


an @ add search rules, asr 


Se 


0 ADDS A DIRECTORY TO THE USER'S SEARCH RULES 


] USAGE: add_search rules path1 {-control_arg path2} 


asr >udd>F01>Student 01>tools -after working dir 


initiated segments 
referencing directory 
working directory 
>udd>FO1>Student O01>tools 


>system_library_ Standard 
>system_ library unbundled 
>system_ library 1 

>system_ library_ tools 
>system library auth_maint 
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\ \ 


‘ DYNAMIC SEARCHING 


>i aaah et aie aap ee 


| DELETES ONE OR MORE DIRECTORIW® FROM THE USER'S SEARCH RULES 
] USAGE: delete search rules paths 
dsr >udd>F01>Student_06>tools 
® initiate, in 
0 ENABLES USERS TO INITIATE (MAKE KNOWN) SEGMENTS DIRECTLY 


1 THE SEGMENTS REFERENCE NAME AND ITS ABSOLUTE PATHNAME ARE 
PLACED IN THE USER'S LIST OF INITIATED SEGMENTS 


] USAGE: initiate path {ref_names} {-control_args} 


in >udd>FED>Kerr>tools>editor 


in >udd>FED>Kerr>tools>editor qx 
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DYNAMIC SEARCHING 
| 
-@ list ref names, Irn ( pas w 


0 LISTS THE REFERENCE NAME, PATHNAME AND SEGMENT NUMBER OF 
SEGMENTS KNOWN TO THE USER'S PROCESS (I.E. INITIATED SEGMENTS) 


] USAGE: list_ref_names {paths}{-control_ args) 
Irn 


Irn >udd>F01>Student_07>add 


@® terminate ref name, tmr 
ees 


a 


| 
0 ALLOWS THE USER TO REMOVE A SEGMENT FROM THE LIST OF SEGMENTS 
KNOWN TO HIS PROCESS (I.E. INITIATED SEGMENTS) 


] USAGE: terminate_ref_name ref_names 


tmr add who 


10-26 . 7 | BO] 


DYNAMIC SEARCHING 


@ where, wh (... HOW I WONDER WHERE YOU ARE!) 


[ — ] 


USES CURRENT SEARCH RULES TO LOCATE AND PRINT THE ABSOLUTE 
- PATHNAME OF A SEGMENT 


l ONLY THE PRIMARY NAME OF THE LOCATED SEGMENT IS PRINTED 
1 MAY BE USED TO CHECK IF A NAME IS "SAFE" TO USE FOR A SEGMENT 


l USAGE: where ref_name {-control_arg} 
wh qx | 
wh sort 
wh wh -all 


wh >udd>F01>Student_06>add.p11 


@ NOTE THAT IN THE SIMPLEST CASE (WHERE A USER LOGS IN, CREATES AND 
EXECUTES PROGRAMS IN HIS HOME DIRECTORY), NO KNOWLEDGE OF SEARCH 
RULES OR INITIATED SEGMENTS IS REQUIRED 


YOU ARE NOW READY FOR WORKSHOP 
| #5 
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What is Access Control 


Access Control List (ACL) 


Access Manipulation Commands 


ACCESS CONTROL 


TOPIC XI 


Default and Initial ACL Entries 


Access Examples . 


Page 


ee ae ey 
SY 
'eteeptiet 


a> wh 


Ww— 


FO1 


This page has intentionally 


Deen left blank. 


1-di . FO1 


WHAT IS ACCESS CONTROL 


ACCESS CONTROL 


i 7 FACILITY FOR CONTROLLING (IN A seeeeitae MANNER): . 
q ACCESS TO THE CONTENTS OF SEGMENTS 
f ACCESS TO THE ATTRIBUTES OF SEGMENTS 
0 ABILITY TO siete cea 


) ABILITY TO DELETE SEGMENTS 


1 A FACILITY ALLOWING USERS TO SELECTIVELY SHARE THEIR PROGRAMS 
AND DATA WITH OTHER USERS 


1 USER MUST EXPLICITLY GRANT (SET) ACCESS IF SHARING IS DESIRED 


1 set_acl, delete_acl & list _acl COMMANDS 


1 SELECTIVE SHARING 
) BY Person_id 
1 BY Project_id. 


I BY ACCESS MODE (READ, WRITE ...) 
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ACCESS CONTROL LIST (ACL) 


ACCESS CONTROL LIST (ACL) 


J EVERY SEGMENT AND DIRECTORY HAS ITS OWN ACCESS CONTROL LIST 
(ACL) 


1 AN ACL IS A LIST OF User_ids-LIKE ENTRIES CALLED ACCESS 
IDENTIFIERS, AND ASSOCIATED ACCESS MODES 


TSmith.ProjaA.* 


0 IN ORDER FOR A USER TO ACCESS A SEGMENT (OR DIRECTORY): 
1 THE USER'S User_id MUST "MATCH" AN ENTRY ON THE ACL 


2 FURTHERMORE, THE USER IS’ RESTRICTED TO THE ACCESS MODE(S) 
SPECIFIED BY THAT PARTICULAR ACL ENTRY 


1 BY DEFAULT, USERS ARE GIVEN COMPLETE ACCESS TO THE SEGMENTS AND 
DIRECTORIES THEY CREATE 


1 USERS MAY ADD AND DELETE ENTRIES FROM THE ACL'S OF THEIR 


SEGMENTS AND DIRECTORIES VIA THE set_acl AND delete acl 
COMMANDS 
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ACCESS CONTROL LIST (ACL) 


2 AN ACL IS CONSIDERED AN ATTRIBUTE OF A SEGMENT OR DIRECTORY. 
IN ORDER TO set_acl OR delete acl, THE USER MUST HAVE THE 
APPROPRIATE PERMISSION TO DO SO 


1 ACCESS VIOLATIONS ARE TRAPPED BY THE SYSTEM AND THE VIOLATOR IS 
INFORMED 


1 ACCESS CHANGES OCCUR INSTANTANEOUSLY SINCE ACCESS RIGHTS ARE 
CHECKED BY HARDWARE WITH EVERY ACCESS | 
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ACCESS CONTROL LIST (ACL) 


igs ACCESS MODES FOR SEGMENTS (rew n) 
@ ACCESS MODES FOR SEGMENIS | 


— 


“— cena 


an 


1 CONTENTS OF THE SEGMENT CAN BE READ BY THE DESIGNATED 
USER(S) 


1 print, copy, move, gedx's "r" request 


ee i oe ee nS 


N aan EXECUTED BY THE DESIGNATED 
OR 


MEAN OBJECT SEGMENTS) 


0 DEPENDING ON THE OBJECT PROGRAM, READ MAY ALSO BE REQUIRED | 
FOR EXECUTION 


HO 


} add, >udd>FO1>Student 01>add 


i eer ea 


WRITE (w) 
_— 


Ne Be Ree i —«,«, 
i esieetertencttin ce aan eneseeennieneiallill 


J CONTENTS OF THE SEGMENT CAN BE MODIFIED (OVER WRITTEN) BY 
THE DESIGNATED USER(S) 


J qedx's "w" request 


=O Ce mats ag 


NULL m > , aan 


AM are eee 


0 ALL ACCESS TO THE CONTENTS OF THE SEGMENT IS’ EXPLICITLY 
DENIED FOR THE DESIGNATED USER(S) 


ACCESS CONTROL LIST (ACL) 


W ACCESS MODES FOR DIRECT ‘S$ .(sma n)---DO NOT INFLUENCE ACCESS ON 
x INFERIOR DIRECTORIES : 


es 


1 ATTRIBUTES OF EXISTING ENTRIES IN THE DIRECTORY CAN BE 
OBTAINED BY THE DESIGNATED USER(S) 


1 status, list 


ee _ 


0 MODIFY (m) / je tt” | 


i} ATTRIBUTES OF EXISTING ENTRIES IN THE DIRECTORY CAN BE 
MODIFIED BY THE DESIGNATED USER(S). 


f ENTRIES CAN ALSO BE DELETED BY THE DESIGNATED USER(S) 


0 add name, rename, delete, set_acl, delete acl 


screen Rg 


1 APPEND ( _ 
an 


1 NEW SEGMENTS, DIRECTORIES, AND LINKS CAN BE CREATED IN (OR 
MOVED TO) THE DIRECTORY BY THE DESIGNATED USER(S) 


l create, create dir, link, copy, move 


Zs 
| iO NULL (a )) 


l ALL ACCESS TO THE ATTRIBUTES OF EXISTING ENTRIES IN THE 
DIRECTORY IS EXPLICITLY DENIED FOR THE DESIGNATED USER(S) 
~AND- THE CREATION OF ENTRIES IN THE DIRECTORY IS EXPLICITLY 
DENIED FOR THE DESIGNATED USER(S) 
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ACCESS CONTROL LIST (ACL) 


ACCESS IDENTIFIERS 


1 THREE-COMPONENT CHARACTER STRING 
Person id.Project id.tag 
0 TAG IDENTIFIES THE TYPE OF PROCESS 
1 a- AN INTERACTIVE PROCESS (A REAL USER) 
1 m - AN ABSENTEE PROCESS (AN "ABSENT" USER) 


ff z- A SYSTEM PROCESS (A DAEMON) LOGGED IN BY THE OPERATOR 


_ [__MULTICS ASSIGNS EVERY USER AN ACCESS IDENTIFIER AT LOG IN 
2 ee ha a ee Te teres 


Sa er 


l WHEN USED IN AN ACCESS CONTROL LIST, ACCESS IDENTIFIERS ARE 
OFTEN CALLED "ACL ENTRIES" 


1. ENTRY IS A STAR (ASTERISK), THE STAR 
IS INTERPRETED AS MATCHING ANY Person id, roject id, OR 


ANY tag, DING ON ITS POSITION IN THE ACCESS IDENTIFIER 
*.FOl.a MATCHES ALL INTERACTIVE FO1 USERS 


Student_09.*.* MATCHES Student _09 REGARDLESS OF 
| HOW HE LOGS IN 


*.# om MATCHES ALL ABSENTEE USERS 


#4 t MATCHES EVERYONE 


ACCESS CONTROL LIST (ACL) 


ATICALLY ORDERED - 


MOST 


FIC IDENTIFIERS FIRST 


Frommer .F0O1.a 
Frommer .F01.* 
Frommer .*.a 
Frommer .*.* 
*.FOl.a 
*.FO1.# 

# .*® a 


© MATCHING User_id WITH ENTRIES ON AN ACL 
Il PROCEEDS FROM TOP TO BOTTOM 
FIRST MATCH DETERMINES ACCESS MODE(S) 


f NO MATCH IMPLIES NO ACCESS 
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ACCESS CONTROL LIST (ACL) 


@ EXAMPLE: LET seg_1 HAVE THE FOLLOWING ACCESS CONTROL LIST 


seg_1's ACL 


LJones.FED.a 
Student _07.F01.* 
TSmith.ProjA.* 
White.#*.* : 
*.ProjA.* 

.FED.* 

.SysDaemon.* 

# .m 


USER USER'S ACCESS 
LJones.FED.a , rew 
LJones.FED.m n 
TSmith.ProjA.a r 
TSmith.FED.a n 


Green. ProjA.a | Papo 
White.ProjA.a Soc 
White.FED.a uss 
LJones.F0O1.m ea 
LJones.FED.m 1 ee 
Kerr.MAC.a cheats 
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“ACCESS MANIPULATION COMMANDS > 


 crcaeetaeect eae 


were 


\ 


J MANIPULATES THE ACL'S OF SEGMENTS AND DIRECTORIES 
In 


1 USAGE: 


sa add.pl1 rw Student _04.F01.* 


sa add.plir *.FO1.* rw *.FED.* 
sa *.pl1r LJones.*.# 


sa dir_A sma LJones.FED.* 


sa *# pr #,# ,# 
~ ee. = 


® delete acl, da 
) REMOVES ENTRIES FROM ACL'S OF SEGMENTS AND DIRECTORIES 
] USAGE: delete _acl {path {User _ids}} 
da add.pl1 *.FO1.# 


da add.pl1 Student_04.F01.* *.FED.* 
da dir A LJones.FED.* 
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_ | / i ey a eee 
{* set_acl, sa) Fa ne a 


FO1 


ACCESS MANIPULATION COMMANDS 


eee 
aaa is a. 


} 


ia 


0 LISTS THE ACL'S OF SEGMENTS AND DIRECTORIES 
Te cn rar eae 


jaune 


1 IF path OMITTED THEN NO User_id POSSIBLE 


l USAGE: list_acl {path {User _ids}} 
la add.plt1 


la add.pl1 LJones.FED.* 
la 
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DEFAULT AND INITIAL ACL ENTRIES 


AERA mags  daenmneeiabiniamemeenereme: — ceemiaiiemmieeten §— anasto antenetec tetanic 


@ WHEN SEGMENTS AND DIRECTORIES ARE CREATED, AN ACL IS AUTOMATICALLY 
PROVIDED BY MULTICS CONTAINING DEFAULT ACL ENTRIES 


1 FOR MOST SEGMENTS: 


Person_id.Project_id.* 


* .SysDaemon. * 


1 FOR DIRECTORIES: 


Person id. Project id.* 


* .SysDaemon.* 


@ NORMAL ACCESS GIVEN TO SYSTEM DIRECTORIES: 
1 A USER IS GIVEN "sma" ON HIS HOME DIRECTORY 
J A USER IS GIVEN ngn ON HIS PROJECT DIRECTORY 
1 <A PROJECT ADMINISTRATOR IS GIVEN "sma" ON THE PROJECT DIRECTORY 


] THE SYSTEM'S ADMINISTRATOR HAS "sma" ON >udd. 
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DEFAULT AND INITIAL ACL ENTRIES 


EE EE EE ee epee eet 


@ INITIAL ACCESS CONTROL LIST 


1 A FACILITY FOR DEFINING ADDITIONAL DEFAULT ACL ENTRIES TO BE 
INCLUDED IN THE ACL OF SEGMENTS AND DIRECTORIES WHEN CREATED 


l DEFINABLE AT THE DIRECTORY LEVEL 


1 REFER TO THE DESCRIPTION OF THE FOLLOWING COMMANDS IN THE 
-MULTICS COMMANDS MANUAL 


set_iacl seg, sis set_iacl dir, sid 
list_iacl_ seg, lis list iacl dir, lid 
delete iacl_ seg, dis delete iacl dir, did 


11-12 FO1 


ACCESS EXAMPLES 


ACCESS EXAMPLE FOR STUDENT_02 


$s sma 
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ACCESS EXAMPLES 


IN WHICH DIRECTORIES CAN Student_02 SUCCESSFULLY EXECUTE THE list 
COMMAND? 


IN WHICH DIRECTORIES CAN Student_02 CREATE A SEGMENT? 


SUPPOSE Student_02 CREATES A SEGMENT IN DIRECTORY Dir_1 BY TYPING 
create UCI eMac Rees 
Sees ere 
CAN Student_02 DELETE THIS cry ye - enel mp 
CAN Student_02 rename THIS SEGMENT? ~.— te 


CAN Student_02 READ AND WRITE THE CONTENTS OF THIS SEGMENT? a 


IN WHICH DIRECTORIES CAN Student 02 SUCCESSFULLY EXECUTE THE 
rename COMMAND? = 
ed ing nae Ss7¢ 2 ee QUR., 2 


IN WHICH PAREEIONY CAN Student_02 SUCCESSFULLY EXECUTE THE set_acl 
COMMAND? 
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ACCESS EXAMPLES 


TO WHICH SEGMENTS CAN Student 02 WRITE? 
DYE 
/ 


TO WHICH SEGMENTS COULD Student_02 EVENTUALLY WRITE BY SETTING THE 
APPROPRIATE ACCESS? 


aang He fid 


SUPPOSE Student _02 CREATES A DIRECTORY UNDER Dir_1 BY TYPING: 


create dir >udd>F01>Student 01>Dir_ 1>Dir 5 


WHAT PERMISSIONS WILL Student _02 HAVE ON THIS DIRECTORY? SM 
WHAT PERMISSIONS WILL Student_01 HAVE ON THIS DIRECTORY? ff 


CAN Student_01 GIVE HIMSELF PERMISSIONS ON Dir 5? (a 
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TOPIC XII 


USER COMMUNICATION | 


Message Facility 
Mail Facility . 
Memo Facility . 
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MESSAGE FACILITY 


(Casas gn tt GE fpr" 


aaa: 


1 TEXT WHICH IS COMMUNICATED BETWEEN USERS VIA THE send message 
COMMAND 


ans 7* 


0 A SEGMENT IN THE DIRECTORY >udd>Project_id>Person_id HAVING THE 
NAME Person_id.mbx 


\ ® accept messages, am 


[ ALLOWS ANY AND ALL INCOMING MESSAGES TO BE PRINTED ON THE 
USER'S TERMINAL 


(I'M LISTENING) 


l OTHERWISE, MESSAGE WILL GO TO THE USER'S MAILBOX 


1 ALSO CREATES A MAILBOX IF NONE EXISTS 


] USAGE: accept_messages {-control args} 
am 
am -print 
am -brief 
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MESSAGE FACILITY 


send message, sm 


0 SENDS A MESSAGE TO A SPECIFIED USER ON A SPECIFIED PROJECT 


1 SMALL MESSAGES (ONE LINE) 


1 MESSAGES ARE EITHER 


1 PRINTED ON THE RECIPIENTS TERMINAL, OR 


1 PLACED IN THE RECIPIENTS MAILBOX 


1 USAGE 1: 
fl USAGE 2: 
(DIALOGUE 


send message Person_id.Project_id message 
sm TSmith.Project_id When are you going to lunch? 


sm Greenberg.FED May I have access to your file? 


send_message Person_id.Project 
MODE ) 


sm TSmith.FED 
Inputs 
When are you going to lunch? 


From TSmith.FED 11/10/78 1546.3 mst Fri: 12:00 
Mary wants to go with us. 


=:Fine, bring her along. 
Meet you in the lobby. 
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MESSAGE FACILITY 


~, 


Alliance BUSY...NO DISTRACTIONS WANTED) 


J REDIRECTS ANY AND ALL INCOMING MESSAGES TO THE USER'S MAILBOX 
1 ELIMINATES UNWANTED INTERRUPTIONS 


] USAGE: defer messages 


dm 


_ print_messages, pm 
0 PRINTS ai MESSAGES STORED IN THE USER'S MAILBOX 
weseaces ARE DELETED FROM THE MAILBOX WHEN PRINTED | 

J USAGE: print_messages {-control_ arg} 


pm 


pm -last 
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MAIL FACILITY 


yf PRINTS ANY AND ALL MAIL (OR MESSAGES) IN A USER'S MAILBOX, OR 


plo SENDS THE CONTENTS OF A SEGMENT TO ANOTHER USER 
1 WHEN SENDING, MAIL IS PLACED IN THE RECIPIENT'S MAILBOX 


1 USAGE 1: mail {path} {-control arg} 
(PRINTING) 


ml 
ml -bf 


ml >udd>FO1>Student_ O4>Student_04.mbx 


] ALSO CREATES A RING-PROTECTED MAILBOX IF NONE EXISTS 


; | 
JI USAGE 2: nait (oath User_ids {-control_ arg} 
; (SENDING) 


mail fwi6.report LJones.FED 
mail letter Student 05.F01 -ack 


mail S_letter.runout TSmith.ProjA Boyd.ProjA 


12-4 F()1 


MAIL FACILITY 


USAGE 3: naii(+/User_ids 
(SENDING) 


mail * LJones.FED TSmith.ProjA 

Input: 

The finance committee will begin meeting 
on Tuesdays at 3:30 starting 

: Coffee will be provided. 


by LAA Fork i 


mbx_create, mber 


RELATED COMMANDS 


-mbx_delete, mbdl 
-mbx_add_name, mban 
mbx_ delete name, mbdn 
mbx rename, mbrn 

mbx_ set acl, mbsa 
mbx_delete_ acl, mbda 
mbx_ list acl, mbla 


mbx_set_max_length, mbsml 
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MEMO FACILITY 


MEMO FACILITY 
1 AN INTERACTIVE NOTEBOOK AND REMINDER LIST 


R/IN A HOME DIRECTORY SEGMENT NAMED 


MEMO 


1 A MESSAGE DELIVERED TO THE USER AT A PREDETERMINED DATE AND 
TIME, OR 


1 A COMMAND EXECUTED BY THE SYSTEM AT A PREDETERMINED DATE AND 
TIME 


1 MATURE MEMOS MAY BE ACTIVATED 
1 EXPLICITLY (VIA THE memo COMMAND), OR 


1 AUTOMATICALLY (WHILE USER IS LOGGED IN) 


1 MEMOS OPERATE INDEPENDENT OF THE accept_messages/defer_messages 
COMMANDS 


MEMO FACILITY 


) CREATES AND MAINTAINS AN INTERACTIVE NOTEBOOK AND REMINDER LIST 


fo 


i 


USAGE 1: memo 


(EXECUTING) 


memo 


USAGE 2: memo 
(LISTING) 


memo 


memo 


USAGE 3: memo 
(SETTING) 


memo 
memo 
memo 
memo 


memo 


USAGE 4: memo 
(DELETING) 


memo 


memo 


-list {optional args} 
-list> 

-list -match Birthday 
{optional_args} memo text 


Good job Tom!!! Keep up the good work! 

~time "Friday 8am est" 10am meeting with Olson 

~date 5/6/78 -repeat lyear Jan's Birthday:May 9 
-call -tm Friday sm May ProjA Report due today. 


-alarm -repeat ilday -time noon Lunch time! 


-delete optional args 


-delete -match Birthday 
~delete -call 
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TOPIC XIII 


MULTICS INPUT/OUTPUT FACILITIES 


Multics Input/Output 


System Input/Output Modules . 


Input/Output Switches . 


Input/Output Commands . 


Examples 


e 


* 
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MULTICS INPUT/OUTPUT 


LOGICAL 1/0 


DEVICE INDEPENDENT 


SYSTEM I/O MODULES CONTROL THE PHYSICAL DEVICES 


I/O "SWITCHES" CHANNEL THE FLOW OF DATA BETWEEN PROGRAM ACCESSIBLE 
STORAGE AND DEVICES, FILES, ETC 
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SYSTEM INPUT/OUTPUT MODULES 


SYSTEM INPUT/OUTPUT MODULES 


] THE Multics SYSTEM CONTAINS THE FOLLOWING I/O MODULES: 


discard_ 


IS A SINK FOR UNWANTED OUTPUT 


rdisk_ 


SUPPORTS I/O FROM/TO REMOVABLE DISK PACKS 


record stream_ 

PROVIDES A MECHANISM FOR DOING RECORD I/O ON AN UNSTRUCTURED 
FILE, OR VICE VERSA 

syn_ 


ESTABLISHES ONE SWITCH AS A SYNONYM FOR ANOTHER 


tape_ansi_ 

SUPPORTS I/O FROM/TO MAGNETIC TAPE FILES ACCORDING TO 
STANDARDS PROPOSED BY THE AMERICAN NATIONAL STANDARDS 
INSTITUTE (ANSI) 

tape ibm_ 

SUPPORTS I/0 FROM/TO MAGNETIC TAPE FILES ACCORDING TO 
STANDARDS ESTABLISHED BY IBM 

tape _mult_ 


SUPPORTS I/O FROM/TO MAGNETIC TAPE FILES IN Multics STANDARD 
TAPE FORMAT 
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SYSTEM INPUT/OUTPUT MODULES 


T tty_ 
SUPPORTS I/O FROM/TO TERMINALS 


3 
1 vfile_ 


SUPPORTS I/O FROM/TO FILES IN THE STORAGE SYSTEM 


) THESE MODULES ARE DESCRIBED IN SECTION III OF THE MPM 
SUBROUTINES AND IN THE MPM PERIPHERAL INPUT/OUTPUT 


] THE USER MAY CONSTRUCT HIS OWN I/O SYSTEM INTERFACE MODULES. 
| SEE "WRITING AN I/O MODULE" IN SECTION IV OF THE MPM SUBSYSTEM 
WRITERS' GUIDE 
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INPUT/OUTPUT SWITCHES 


SOFTWARE CONSTRUCT WHICH MAKES I/O DEVICE INDEPENDENT 


CONNECTS THE SOURCE OF A READ OR WRITE TO THE TARGET (FILE, TAPE, 
ETC.) THROUGH A SYSTEM I/0 MODULE 


PROGRAM 


1/0 SWITCH 
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INPUT/OUTPUT SWITCHES 


TO PERFORM I/0, THE FOLLOWING FIVE STEPS MUST BE CARRIED OUT 
(EITHER EXPLICITLY OR IMPLICITLY): 


1) 


2) 


3) 


4) 


5) 


ATTACH AN I/O SWITCH. THIS STEP SPECIFIES THE SEGMENT 
PATHNAME, TAPE VOLUME NAME, ETC. FROM/TO WHICH THE 
INPUT/OUTPUT OPERATION IS MADE AND THE I/0 MODULE WHICH 
PERFORMS THE OPERATION (vfile_, tape _ansi_, etc.) 


OPEN THE I/O SWITCH. THIS STEP PREPARES THE SWITCH FOR A 
PARTICULAR MODE OF PROCESSING (E.G. READING RECORDS 
SEQUENTIALLY) USING THE ALREADY ESTABLISHED ATTACHMENT 


PERFORM THE REQUIRED DATA TRANSFER WORKING THROUGH THE SWITCH 
CLOSE THE I/O SWITCH 


DETACH THE I/0 SWITCH 


SWITCHES MAY BE ATTACHED BY 


io_call COMMAND 
SUBROUTINE CALL TO iox $attach_ioname 
LANGUAGE OPEN STATEMENT (IF NOT PREVIOUSLY ATTACHED) 


DEFAULT WHEN RUNNING FORTRAN, PL/1, AND COBOL 


13-5 FO] 


INPUT/OUTPUT SWITCHES 


SWITCHES MAY BE OPENED BY 

1 io call COMMAND 

I SUBROUTINE CALL TO iox_$open LANGUAGE 
I LANGUAGE OPEN STATEMENTS 


] DEFAULT WHEN RUNNING FORTRAN, PL/1, AND COBOL 


DATA TRANSFER MAY BE PERFORMED BY: 

1 io call COMMAND 

] SUBROUTINE CALL TO iox_, ioa_ 

2 get, put, read, write, etc. in PL/1 
1 read, write, ete. in FORTRAN 

] read, write, etc. in COBOL 


0 I/O STATEMENTS IN OTHER LANGUAGES 
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FO1 


INPUT/OUTPUT SWITCHES 


@ THE I/0 SWITCH MAY BE CLOSED BY: 
1 io _call COMMAND 


1 LANGUAGE close STATEMENT (IF THE SWITCH WAS OPENED BY A 
LANGUAGE OPEN STATEMENT 


1 close file COMMAND 


@® THE I/O SWITCH MAY BE DETACHED BY: 
1 io call COMMAND 
J SUBROUTINE CALL TO iox $detach iocb 


0 LANGUAGE close STATEMENT (IF THE SWITCH WERE ATTACHED BY THE 
LANGUAGE open STATEMENT) 
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INPUT/OUTPUT SWITCHES 


FOUR SWITCHES ATTACHED DURING PROCESS cHESTION (login, new_proc) 
l unen ose 

i user sopue 

0 user_output 


0 error_output 


user_i/o IS ATTACHED TO THE USER'S TERMINAL THROUGH tty_ AN, 
OPENED FOR STREAM INPUT AND OUTPUT 


user input, user_output, - and error output ARE ATTACHED TO 
user i/o THROUGH syn_ AND ARE OPENED FOR INPUT, OUTPUT, AND OUTPUT 
RESPECTIVELY . : 
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INPUT/OUTPUT SWITCHES 


PROCESS 


i 


STANDARD ATTACHMENTS 
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INPUT/OUTPUT COMMANDS 


io call, io 
PERFORMS AN OPERATION ON A DESIGNATED I/O SWITCH 


J USAGE: io_call opname switchname {args} 
io attach payroll _ tape tape ansi_ payrol 
-cr -nm employee rec 
-nb 1 -retain all 
io attach poem vfile_ >udd>FO1l>Student_ O02>The Ravin 


io open poem stream_input 
lo close poem 
io detach poem 
close file, cf 
0 CLOSES SPECIFIED FORTRAN AND PL/1 FILES 
] USAGE: close file {-control_arg} filenames 


close file poem file08 


close file -all 
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_ INPUT/OUTPUT COMMANDS 


@® print_attach table, pat 


0° PRINTS INFORMATION ON THE USER'S TERMINAL ABOUT I/O SWITCH 
ATTACHMENTS 


I USAGE: print _attach table {-control_args} {switch_names} 
pat | 
pat poem 


® file output, fo 


1 DIRECTS ALL SUBSEQUENT USER'S OUTPUT (TERMINAL OUTPUT) TO A 
SEGMENT UNTIL THE revert_output COMMAND IS ENCOUNTERED 


1 ATTACHES user_output TO A SPECIFIED OUTPUT FILE 


J ERROR MESSAGES (IF THEY OCCUR) STILL APPEAR ON THE USER'S 
TERMINAL 


1 USAGE: file output {path} 


fo who save 


fo 
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INPUT/OUTPUT COMMANDS 


@® revert output, ro 
0 RESTORES USER'S OUTPUT (TERMINAL OUTPUT) TO THE TERMINAL 


0 USAGE: revert _output 


ro 
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INPUT/OUTPUT COMMANDS 


| 


I TERMINAL | 


file_output my_file 


13=13 


user_outnut sf 


INPUT/OUTPUT COMMANDS 


copy file, cpf 
0 COPIES RECORDS FROM A STRUCTURED INPUT FILE TO AN OUTPUT FILE 


1 USAGE: copy file in_ctrl_arg out_ctrl_arg {-control_args} 


epf -input_description "vfile_ >udd>FO1>Student_01>funky" 
-output switch funky_ sw , 


epf -isw funky _sw -ods "tape_ansi foo -nm first file -nb 1" 


epf -ct 13 -ids "tape _ansi_ 887677 -nm TEST21 -ret all" 
-ods "record _stream_ user_output" 


anf dieu in —~new aint -from H2 ~ta 72 
wpe ere at ww ve way rn) ate ee ww ww 
copy cards 


0 COPIES SPECIFIED CARD IMAGE SEGMENTS FROM THE SYSTEM POOL 
STORAGE INTO A USER'S DIRECTORY 


1 THE SEGMENTS TO BE COPIED MUST HAVE BEEN CREATED USING THE 
Multics CARD IMAGE FACILITY 


] USAGE: copy_cards deck_name {pathname} 


copy_cards card deck 


copy_cards card deck my file 
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EXAMPLES 


® EXAMPLE 1 


1 READ RECORDS FROM A TAPE WITH A VOLUME NAME OF Payros AND A 
FILE NAME OF emp 


0 READ THESE RECORDS ONE AT A TIME FROM COMMAND LEVEL 


! io attach pt tape _ansi_ payrol -name emp -nb 1 -ret all 
! io open payroll tape sequential input | 
! pat pt 
pt tape_ansi_ payrol -name emp -nb 1 -ret all sequential input 


! io read pt 85 
io call: 85 characters returned. 15093Robert Redford 5534 W.Yucca 


! io read pt 85 

io call: End of information reached. No data returned by pt. 
{ io close pt 
! pat pt 

pt tape_ansi_ payrol -name emp -number 1 -retain all 


(not open) 
! io detach pt 


) NOTE: THE TAPE RESOURCES WERE ALLOCATED PRIOR TO THE ATTACH. 
OTHERWISE, A MESSAGE WHICH WOULD INDICATE THE TAPE WAS BEING 
MOUNTED WOULD HAVE BEEN RETURNED AFTER THE io attach 
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EXAMPLES 


@ EXAMPLE 2 
1 READ DATA FROM A FILE AND WRITE TO ANOTHER 


J USING THE SAME PROGRAM, READ FROM A FILE AND WRITE TO THE 
TERMINAL. (USE io call AND ATTACH THE OUTPUT SWITCH EXTERNAL 
TO THE PROGRAM) | 


1 THE PROGRAM: 


example 2: proc; 
del payroll_ in file, 
Aanww A 4q ae «6S 4 la 
sysprint file, 
1 emp_record, 
2 pay_no char (5), 
2 emp, 
3 name char (20), 
3 address char (20), 
(endfile, record, transmit) condition; 


on endfile (payroll_in) go to fini; 

on record (payroll in) ; 

on transmit (payroll_in) begin; 
put skip list 
("TRANSMIT ERROR. LAST RECORD READ WAS:", emp record); 
go to fini; 

end; 


open file (payroll in) 

title ("vfile_ payroll file") input; 
open file (payroll out) 

title ("vfile_ payroll _ file 2") output; 


do while ("1"b); 
get file (payroll_ in) list (emp record); 


put file (payroll _out) skip list (emp_ record); 
end; 


fini: close file (payroll_in), file (payroll_out); 
put skip list ("done"); 
end example 2; 
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EXAMPLES 


J INPUT FILE, payroll file: 
"12002", "Barbara Striesand", "4040 N. 30th lane" 


"15093", "Robert Redford", "5534 W. Yucca" 
"15666", "Julie Christie", "3322 W. Milky Way" 


0 SEQUENCE OF EXECUTION 
example 2 


done 
pr payroll file 2 


payroll file 2 11/09/78 1710.8 mst Thu 
"12002" "Barbara Striesand " "HO40 N. 30th Lane " 
"15093" "Robert Redford " 15534 W. Yucca © " 
"175666" "Julie Christie " "3322 W. Milky Way " 
! pat 
user_i/o tty_ tty724 Sstream_input_ output 
user input syn_ user_i/o 
user output - syn user_i/o 
error output syn_ user_i/o 
sysprint Ssyn_ user_output 


io attach payroll out syn_ user_output 
pat payroll out 
payroll out > syn_ user_output 
example 2 | 


"12002" "Barbara Striesand " tHO4¥O N. 30th Lane " 


"15093" "Robert Redford " 15534 W. Yucca " 
"15666" "Julie Christie " 3322 W. Milky Way et 
done 

pat payroll out 

payroll out Syn_ user_output 
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EXAMPLES 


YOU ARE NOW READY FOR WORKSHOP 
#6 
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EXAMPLES 


EXAMPLE 3 


bd 


ae 


1 READ A DECK OF CARDS INTO THE SYSTEM AND CREATE A SEGMENT IN 
YOUR WORKING DIRECTORY CONTAINING THE CARD IMAGES 


1 STEP 1: YOU MUST BE REGISTERED BY THE SYSTEM ADMINISTRATOR FOR 
CARD INPUT. YOU WILL RECEIVE A PASSWORD FOR YOUR CARD DECKS 


I: “STEP -2% CREATE A SEGMENT IN YOUR HOME DIRECTORY CALLED 
card _input.acs 


0 STEP 3: SET ACL ON THE SEGMENT TC "r" FOR <STATION ID>.*.* AN¢ 
FOR Card Input.Daemon.* 


? STEP 4: PREPARE THE CARD DECK 
++DATA DECK NAME PERSON _ ID PROJECT ID 
++PASSWORD xxx 


++FORMAT MCC LOWERCASE 
++INPUT 


Q STEP 5: SUBMIT THIS DECK TO THE OPERATOR. A MESSAGE WILL BE. 
SENT TO YOU WHEN IT HAS BEEN READ 


] STEP 6: EXECUTE THE COPY CARDS COMMAND 


copy_cards deck name 
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TOPIC XIV 


MORE ABOUT THE ABBREV PROCESSOR 


The do Command .......4+e+.-. ; bee ‘ 
Areas for Additional Study ..... 2. © © © 2 © © eo ew ew DHHS 
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THE DO COMMAND 


@ MOTIVATION: 
J WOULD LIKE TO BE ABLE TO DO THE FOLLOWING: 
-ab PL1 ind; pli 


PL1 add.pl1 


1 WHICH EXPANDS TO: 
ind; pli add.pli 


] BUT WANT: 


. ind add.pl1; pl1 add.pl1 


0 SUBSTITUTES SUPPLIED ARGUMENTS INTO A COMMAND LINE 
1 PRIMARILY INTENDED FOR USE IN ABBREVIATIONS 
1 USAGE: do "command line" args 

do ope gO ger -pli 


do "ind &1; ind &2; ind &3" add.pli sub.pl1 mult.pl1 
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THE DO COMMAND 


COMMAND LINE FLOW 


TYPED LINE 
FRONT-END PROCESSOR 
{ABBREV PROCESSOR} 
COMMAND PROCESSOR => do COMMAND PROCEDURE 


EXECUTION 
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THE DO COMMAND 


EXAMPLES USING THE FOLLOWING ABBREVS: 


do “ind &1; pli &1" 


do "PL1 &1; dp &1" 


do "ind &1.pl1; pli &1.pl1; &1".. 


0 EXAMPLE 1: 


PL1; add.pl1 7 
ra "ind &1; pli &1"l add.plt 


ind add.pl1; pli add.pll 


2 EXAMPLE 2: 


PL1 EX,add 
b= Mind &1.pl1; pl1 &1.pl1; &1"l add 


ind add.pl1; pli add.pl1; add 
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(AS TYPED) 
(ABBREV PROCESSOR) 
(DO COMMAND) 


(AS TYPED) 


(ABBREV PROCESSOR) 


(DO COMMAND) 


FO1 


THE DO COMMAND 


0 EXAMPLE 3: 


PL1_DP add.pli | | (AS TYPED) 


do "PL1 &1; dp &1" add.pll (ABBREV PROCESSOR) 
PL1. add.pl1; dp add.pit | (DO COMMAND) 
do “ind &1; pl1 &1" add.pl1; dp add.pl1 (ABBREV PROCESSOR) 
ind add.pl1; pl1 add.pl1; dp add.pl1 (DO COMMAND) 
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AREAS FOR ADDITIONAL STUDY 


@ ADDITIONAL DOCUMENTATION 


1 MPM COMMANDS AND ACTIVE FUNCTIONS (AG92)_ 


1 help abbrev 


@® STUDY TOPICS 


1 ADDITIONAL abbrev REQUESTS 


1 wu | (USE ANOTHER PROFILE) 

] .p (PRINT THE PATHNAME OF THE PROFILE BEING 
USED) 

D .af_ (FORCE REDEFINE) 

1 .abf (FORCE REDEFINE) 

1 or (REMEMBER MODE) 

1 .f (FORGET MODE - THE DEFAULT) 

I .s (SHOW LAST LINE) 
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TOPIC XV 


ACTIVE FUNCTIONS 


Page 


What is an Active Function . 
Active Function Mechanism. . 
Active Function Examples . . 
Areas for Additional Study. 


Shah ae, age Tete pn eee By SAT 
ee Crean Ce 
Fee ete Bae Bards a ae WO 
sf See ca wes ai- othe iap a eT 


es e ° € 
e 

e s e e 
e 
e 
* 
e 


15-1 . FO1 


This page has intentionally 


peen lieft blank. 


15-ii FO1 


WHAT IS AN ACTIVE FUNCTION 


inte 0 EE EE ee 


ACTIVE STRING 


§ A SUB-STRING (A PART) OF A COMMAND LINE DELIMITED (SET OFF) BY 
SQUARE BRACKETS 


I INTENDED TO BE REPLACED BY A CORRESPONDING VALUE 


] EXAMPLES: 


sm [last message sender] Thank you! 
sm LJones.ProjA Thank you! 


delete [oldest segment] 
delete seg 1 


] LIKE A DYNAMIC (OR VARIABLE) ABBREVIATION 
] FREQUENTLY USED WITHIN ABBREVIATIONS 


I THERE ARE MORE THAN 70 ACTIVE STRINGS DEFINED BY MULTICS 
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WHAT IS AN ACTIVE FUNCTION 


@ ACTIVE FUNCTION 


A PROGRAM EXPLICITLY DESIGNED TO EVALUATE AND RETURN THE VALUE 
OF AN ACTIVE STRING 


USERS MAY DEFINE THEIR OWN ACTIVE STRINGS AND WRITE THEIR OWN 
CORRESPONDING ACTIVE FUNCTIONS 


MANY ACTIVE FUNCTIONS MAY ALSO BE INVOKED AS COMMANDS 
last_message sender 


aAatbka 
uwUuavue 
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” 


ACTIVE FUNCTION MECHANISM 


ACTIVE FUNCTION MECHANISM 
| ACTIVE STRINGS ARE IMMEDIATELY EVALUATED (EXECUTED) | 


1 THE RESULTING VALUE IS SUBSTITUTED FOR THE ACTIVE STRING IN THE 
COMMAND LINE 


] THE COMMAND LINE IS THEN RETURNED TO THE COMMAND PROCESSOR 


COMMAND LINE FLOW 


TYPED-LINE 
FRONT-END PROCESSOR 


{ABBREV PROCESSOR} 


COMMAND PROCESSOR = ACTIVE FUNCTION 


¥ 
EXECUTION 
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ACTIVE FUNCTION EXAMPLES 


e last_message_sender, lms 


0 RETURNS THE User_id OF THE SENDER WHO SENT THE LAST MESSAGE 
RECEIVED 


J USAGE 1; last_message_sender 


lms . 
LJones.FED 


l USAGE 2: [last message sender] 


sm (imsj] THANK YOU! 
sm LJones.FED THANK YOU! 


who [lms] 
who LJones.FED 


0 RETURNS THE PATHNAME OF THE USERS WORKING DIRECTORY 


2 USAGE 1: wd 


wd 
>udd>FED>May 


| USAGE 2: [wd] 


sm Kerr.FED THE pathname is [wd]>add.pl1 
sm Kerr.FED THE pathname is >udd>FED>May>add.pli 
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e date 


ACTIVE FUNCTION EXAMPLES 


RETURNS THE DATE IN mm/dd/yy FORM 


USAGE 1: 


USAGE 2: 


@ home dir 


] 


I 


USAGE 1: 


USAGE 2: 


date {dt} 


date. 
11/01/77 


date "12 June" 
06/12/78 


[date {dt}] 


create alpha.version [date].pl1 
create alpha.version_11/01/77.p11 


RETURNS THE PATHNAME OF THE USERS HOME DIRECTORY 


home_dir 


home_dir 
>udd>F01>Student_07 


C[home_dir] 


pr [home _dir]>add.pli 
pr >udd>F01>Student_07>add.p11 
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ACTIVE FUNCTION EXAMPLES 


segments, segs 


0 RETURNS THE ENTRYNAMES (SEPARATED BY A’ BLANK) OF ALL SEGMENTS 
MATCHING A GIVEN STARNAME 


] USAGE: [segments starname] 


dprint [segs **.p11] | 
dprint add.pl1 seg 1.pl1 


0 RETURNS THE CONTENTS OF A SPECIFIED ASCII SEGMENT SEPARATED B’ 
BLANKS ‘ 


l USAGE: [eontents path] 


sm TSmith.FED Their names are: [contents Names] 
sm TSmith.FED Their names are: LJones.FED Kerr.MED 


mail letter.2 [contents Names] 
mail letter.e2e LJones.FED Kerr.MED 
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AREAS FOR ADDITIONAL STUDY 


ADDITIONAL DOCUMENTATION 


MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 


J help <active function name> 


STUDY TOPICS 


ARITHMETIC ACTIVE FUNCTIONS 


] ceil, divide, floor, max, min, minus, mod, plus, quotient, 
times, trunc 


CHARACTER STRING ACTIVE FUNCTIONS 


1 default, format_line, index, index set, length, search, 
string, substr, underline, unique, verify 


DATE AND TIME ACTIVE FUNCTIONS 


1 date, date time, day, day name, hour, long date, minute, 
month, month_name, time, year 


LOGICAL ACTIVE FUNCTIONS 


J and, equal, exists, greater, less, nequal, ngreater, nless, 
not, or 
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AREAS FOR ADDITIONAL STUDY 


PATHNAME MANIPULATION ACTIVE FUNCTIONS 


[I directory, entry, equal _ name, path, Strip, strip entry, 
suffix : } 


QUESTION ASKING ACTIVE FUNCTIONS 


) query, response 


STORAGE SYSTEM ATTRIBUTES ACTIVE FUNCTIONS 


1 ilv_attached, status 


STORAGE SYSTEM NAMES ACTIVE FUNCTIONS 


q directories, files, get_pathname, home_dir, links, 
nondirectories, nonlinks, nonsegments, pd, segments, wd 


USER PARAMETER ACTIVE FUNCTIONS 


1 have mail, last_message_ sender, last_message time, 
last message, system, user 
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MORE ABOUT EXEC COM'S 


Review. : 
Argument Substitution ae 
Control Statements .. . 


Exec com Examples . . 
Areas for Additional Study 
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REVIEW 


EXEC COM 

lA SEGMENT CONTAINING A SERIES OF COMMAND LINES . 
1 CREATED USING A TEXT EDITOR 

1 NAME sige HAVE SUFFIX OF ec 


l THE COMMAND LINES ARE EXECUTED SEQUENTIALLY, AS A SET, WHENEVER 
INVOKED BY THE USER 


q ABBREVIATIONS ARE EXPANDED IN THE NORMAL MANNER 


] MAY BE RECURSIVELY INVOKED © 


exec com, ec 


0 EXECUTES THE COMMAND LINES CONTAINED IN AN EXEC COM SEGMENT 


I USAGE: exec com 


ec weird.ec flower tree add 
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REVIEW 


EXEC COM LINE FLOW 


EXEC_COM LINES 


COMMAND PROCESSOR 


EXECUTION 


FO1 


ARGUMENT SUBSTITUTION 


@ ARGUMENT SUBSTITUTION 


[ —— } 


CERTAIN CHARACTER STRINGS ARE REPLACED BY A CORRESPONDING VALUE 
BEFORE THE EXEC COM IS EXECUTED 


EXAMPLES USING EITHER OF THE FOLLOWING COMMAND LINES 


ec weird.ec flower tree add 
ec >udd>FO1>Student O5>weird.ec flower tree add 


) &<number> 


1 REPLACED BY THE CORRESPONDING OPTIONAL ARGUMENT 
(POSITIONAL) 


&1 ¢—flower 
&3 ¢—add 
&5 @— <nothing> 


REPLACED BY THE NUMBER OF ARGUMENTS SUPPLIED 
&n ¢—3 


1 &ec_name 


0 REPLACED BY THE ENTRYNAME PORTION OF THE EXEC COM'S 
PATHNAME WITHOUT THE ec SUFFIX 


kee name 4——weird 


0 &ec dir 


0 REPLACED BY THE DIRECTORY NAME PORTION OF THE EXEC COM 
PATHNAME = 


&ec dir ¢—>udd>F01>Student_05 
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CONTROL STATEMENTS 


CONTROL STATEMENTS 
J EXEC_COM LINES THAT BEGIN WITH SPECIAL KEY WORDS 
1 ALL KEY WORDS BEGIN. WITH & (AMPERSAND) 


PROVIDE VARIETY AND CONTROL DURING EXECUTION 


&command_ line off 


0 SUPPRESSES THE PRINTING OF SUBSEQUENT COMMAND LINES 


1 USAGE: &command_line off 


&command line on 


1 CAUSES SUBSEQUENT COMMAND LINES TO BE PRINTED. (THE DEFAULT) 


J USAGE: &command_line on 
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CONTROL STATEMENTS 


@® é&print text 


q CAUSES THE TEXT FOLLOWING &print TO BE PRINTED ON THE USER'S 
TERMINAL : 


q USAGE: &print text 
&print BEGINNING COMPILE PHASE 


\ 


setae 


ie. 


Q IDENTIFIES A PLACE TO WHICH AN &goto TRANSFERS CONTROL 


0 USAGE: &label label_name 
&label Arg Check 


&label &1 


rare 


@ &goto location 


0 CAUSE CONTROL TO BE TRANSFERRED TO THE PLACE SPECIFIED 
J USAGE: &goto label name 


&goto Arg Check 
&goto &1 
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Stey ~ modes eheplex polite seer 


CONTROL STATEMENTS 


&if, &then, é&else i ae Ln 2 ee 
= eee ae ae d 


2 ard fe habon Fife tly Lele be 
0 ALLOWS EXEC _COM LINES TO BE CONDITIONALL GER ere 


J USED WITH LOGICAL ACTIVE FUNCTIONS (WHICH RETURN "true" OR 
"false") 


1 USAGE 1: &if (ACTIVE FUNCTION {args}] 
&then EXEC _COM STATEMENT - 


&if [exists seg add.pli] 
&then pli add.pl1;add 


0 USAGE 2: &if [ACTIVE FUNCTION {args}] 
&then EXEC COM STATEMENT 
&else EXEC COM STATEMENT 


&if [equal [wd] [home dir]] 


&then &goto OK 
&else &print Assuming working dir is correct 


0 USED TO INDICATE A COMMENT LINE 


1 USAGE: & text 


& THIS EXEC_COM DETERMINES THE USER'S Project_ id 
& AND THE TIME OF DAY IN ORDER TO 
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CONTROL STATEMENTS 


pexeet SAIN EN ey, 


— ES 
/e aquit_- 


) ee 


Nf CAUSES EXECUTION OF THE EXEC COM TO HALT (DEFAULT AT END OF 
SEGMENT ) 


USAGE: &quit 


peace nas AS UNA mea 


CAUSES SUBSEQUENT COMMANDS WHICH NORMALLY TAKE THEIR INPUT FROM 
THE TERMINAL TO TAKE THEIR INPUT FROM THE EXEC COM SEGMENT 


| | | gears pag oe 
I USAGE: &attach => gree por PO 


0 EXAMPLES: 


qedx REQUESTS ARE | qedx REQUESTS ARE 
READ FROM TERMINAL READ FROM EXEC_COM 


&command line off 
ewd >udd>FED>May 
qedx 
ecwd >udd>FED>Kerr 


&command line off 
&attach 
cwd >udd>FED>May 


q 
cwd >udd>FED>Kerr 
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CONTROL STATEMENTS 


FR vsep TO REVERT &attach 


0 CAUSES SUBSEQUENT COMMAND WHICH NORMALLY TAKE THEIR INPUT FROM 
THE TERMINAL TO CONTINUE TO TAKE THEIR INPUT FROM THE TERMINAL 


anna annRnRae 


a 
THE DEFAULT WHEN ENTERING AN EXEC COM 


peace AH 


] USAGE: &detach 


@ é&input_line off 


f SUPPRESSES THE PRINTING OF SUBSEQUENT zneut LINES (SUCH AS 
REQUEST LINES) 


] USAGE: &input_line off 


eet a 


0 CAUSE SUBSEQUENT INPUT LINES TO BE eee es 
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CONTROL STATEMENTS 


@ éready on 


CAUSES THE INVOCATION OF THE USER'S READY PROCEDURE AFTER THE 
EXECUTION OF EACH COMMAND LINE WITHIN THE EXEC COM 


s sidaagte \ 


(DEFAULT) 


) CAUSES THE USER'S READY PROCEDURE NOT TO BE INVOK 
WITHIN THE EXEC COM | 


‘@ = ~exec_com DEFAULTS: 


&command_line on 


&input line on 


&ready off 


&detach 
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EXEC COM EXAMPLES 


@ EXAMPLE 1: LET pli_pr.ec CONTAIN: 


pli_pr.ec 


| ind &1.pl1 | 


pii &i.pii -map 
dp &1.list 


ind &2.pl1 
pli &2.pl1 -map 


dp &2.list 


A 


0) LET THE COMMAND LINE BE: ec pli_pr.ec add sub 


LET THE COMMAND LINE BE: ec pli1_pr.ec sub 


@ EXAMPLE 2: LET pli_pr.ec CONTAIN: 


pli_pr.ec 


&command line off 
&if [nless &n 1] &then &quit 


ind &1.pl1 
-| pll &1.pli -map 
| dp &1.list_ 
&if (nequal’&n 1] &then &quit 


ss, 


ind &2.pl11 

pli &2.pl1 -map 
dp &2.list 
&quit 
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EXEC COM EXAMPLES 


@® EXAMPLE 3: LET pl1_pr.ec HAVE AN ADD NAME OF pli_pr_.ec AND 
CONTAIN: | 


pli _pr.ec 
pli_pr_.ec 


&goto. &ec name 

&label pl? _pr 

&command line off 

&print Beginning &ec name exec com 

&if [ngreater &n 0] &then &goto pli _pr_ 
&print Usage is: ec &ec name.ec paths — 
&quit 


&label plil_pr_ 

dl &1 -brief 

ind &1.pl1 

pli &1.pl1 -map 

& CHECK FOR A SUCCESSFUL COMPILE. (WAS OBJECT CREATED). 
| &if [exists segment &1] &then dp &1.list 


&if (ngreater &n 1] &then ec &ec dir>pll_pr_.ec &2 &3 &4 
&quit 
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EXEC COM EXAMPLES 


ADDITIONAL EXAMPLES OF EXEC COM CONTROL STATEMENTS: 
&if [equal [day name] Monday] &then ..... 
&if {query "Do you really ...?"] &then......... 
&if [equal all [response "How many do you want?"] ] &then ..... 
kif [equal TSmith.FED [last_message sender] ], &then ....... 
&if [equal S [substr [user name] 1 1] ] &then ........ 
&if [equal 0 [min &1 & &3 &4] ] &then ........ 


&if for fequal .... seeed (less: «.2% weae] ] &then ...... 
&if [nless 0 Lindex "&1 &2 &3 &4" -all] J] &then ....... 
&if [equal 0 [mod &n 2] ] &then ....... 
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AREAS FOR ADDITIONAL STUDY © 


@ ADDITIONAL DOCUMENTATION OF exec_com FACILITIES: 
qd MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 


l help exec_com 


@ STUDY TOPICS 


2 ARGUMENT SUBSTITUTION 
J &qi, &ri (QUOTING AND REQUOTING OF ARGUMENTS) 
0 &fi (THE ARGUMENT STRING STARTING WITH THE iTH ARGUMENT) 


] &qfi, &rfi (QUOTING AND REQUOTING OF ARGUMENT STRINGS) 


|} CONTROL STATEMENTS 


I &print CONTROL STRINGS: “*/, *3/, “-, “4+, 71, 721, 77 


YOU ARE NOW READY FOR WORKSHOP 
#7 
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TOPIC XVII 


ABSENTEE USAGE 
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WHAT 1s ABSENTEE USAGE 


@ ABSENTEE FACILITY 


l 


A FACILITY FOR RUNNING BACKGROUND JOBS (i.e. BATCH JOBS) 


GIVES USERS THE ABILITY TO EXECUTE LARGE JOBS WITHOUT WAITING 
AT THE TERMINAL WHILE THE JOB IS IN PROGRESS 


CHARGES FOR ABSENTEE USAGE IS USUALLY LOWER THAN CHARGES FOF 
INTERACTIVE USAGE 


A. USER MAY RUN MANY ABSENTEE JOBS AT ONCE, BUT IS SUBJECT TO. 
THE CURRENT SYSTEM LIMIT ON THE NUMBER OF ABSENTEE JOBS 


LANGUAGE FOR ABSENTEE USAGE IS IDENTICAL TO THE INTERACTIVE 
COMMAND LANGUAGE 


@ PROCESS 


A PROGRAM CREATED FOR THE USER AT LOG IN, AND DESTROYED AT L0G 
OUT | 


AN ACTIVE AGENT WHICH DOES WOR! 


aN 
“s} 
(@) 
bo, © 
J 
ww 
ic 
co 
w 
rl 
be +] 


LIKE A PRIVATE COMPUTER, WORKING IN ITS OWN MEMORY UNDER THE 
CONTROL OF THE USER , 
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WHAT IS ABSENTEE USAGE 


@ INTERACTIVE USAGE 
1 USING MULTICS INTERACTIVELY VIA A TERMINAL 


l USER'S PROCESS INTERACTS WITH THE USER 


@ ABSENTEE USAGE 
l USING MULTICS WHILE ABSENT FROM A TERMINAL 
0 USER'S PROCESS "INTERACTS" WITH AN INTERACTIVE SCRIPT 


2 AN ABSENTEE JOB IS A "PLANNED" INTERACTIVE TERMINAL SESSION 
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WHAT IS ABSENTEE USAGE 


ABSENTEE MECHANISM 


i |} 


USER CREATES AN ABSENTEE INPUT SEGMENT CONTAINING COMMANDS TO 
BE EXECUTED | 


THE ABSENTEE INPUT SEGMENT 
J] MUST HAVE SUFFIX OF absin 


2. CONTAINS A PLANNED INTERACTIVE SCRIPT, INCLUDING PRESET 
ANSWERS TO ANTICIPATED QUESTIONS 


J HAS THE SAME SYNTAX AS EXEC COM SEGMENTS 


USER REQUESTS THE EXECUTION OF THE ABSENTEE INPUT SEGMENT VIA 
THE enter_abs_request COMMAND 


EXECUTION MAY BE DEFERRED UNTIL A SPECIFIED DATE AND TIME 


THE ABSENTEE REQUEST IS QUEUED AND RUN AS BACKGROUND TO THE 
NORMAL INTERACTIVE WORKLOAD ~~ 


ALL OUTPUT NORMALLY DIRECTED TO THE TERMINAL IS REDIRECTED TO A 


SEGMENT HAVING THE SAME NAME AS THE ABSENTEE INPUT SEGHEN 
EXCEPT THE SUFFIX IS absout 
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WHAT IS ABSENTEE USAGE 


INTERACTIVE USAGE 


COMMANDS 
RESPONSES 
USER’S 
TERMINAL 
| FILE 1/0 
DATA 
Ea 
ABSENTEE USAGE 
A.absin 
COMMANDS = if a 
USER‘S ee 
PROCESS RESPONSES Eaal 
A.absout 


FILE 1/O 
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WHAT IS ABSENTEE USAGE 


® THE ABSENTEE PROCESS WHICH RUNS THE JOB: 


f LOGS INTO THE SYSTEM AS DOES ANY USER (EXCEPT FOR PASSWORD 
AUTHENTICATION) 


0 EXECUTES THE ABSENT USER'S start_up.ec 
0 BEGINS WORKING IN THE ABSENT USER'S HOME DIRECTORY 
l TAKES ITS COMMANDS FROM THE ABSENTEE INPUT SEGMENT 


1 APPEARS (AND IS) ANOTHER USER HAVING THE ABSENT USER'S User_id 


@ COMMAND LINE FLOW 


ABSENTEE INPUT 
{ABBREV PROCESSOR} 
COMMAND oo 


‘ 


EXECUTION 
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WHAT IS ABSENTEE USAGE 


NOTES ON ABSENTEE USAGE 


1 start up.ec SHOULD BE MODIFIED TO RESPOND DIFFERENTLY TO AN 
ABSENTEE LOG IN 


\ 
J THE SYSTEM EXECUTES A USER'S start_up.ec WITH ONE OF THE 
FOLLOWING COMMAND LINES: 
ec start_up.ec login interactive 
ec start_up.ec login absentee 


ec start_up.ec new proc interactive 
ec start _up.ec new_proc absentee 


2 THE USER MAY QUERY THE ARGUMENTS USING exec _com LINES 
SIMILAR TO THE FOLLOWING: 


&if [equal &1 login) &then ... 
&if [equal &2 absentee] &then ... 


0 THE ABSENTEE INPUT SEGMENT MUST CONTAIN change _wdir COMMAND IF 
WORKING DIRECTORY IS TO BE OTHER THAN HOME DIRECTORY 


f THE ABSENTEE INPUT SEGMENT OFTEN (BUT NEED NOT) HAS logout AS 
FINAL COMMAND 


1 &attach HAS NO SIGNIFICANCE IN AN ABSENTEE INPUT SEGMENT SINCE 
ALL USER INPUT IS ATTACHED TO absin FILE 


] IF THE ABSENTEE JOB CANNOT BE RUN, OR IF IT TERMINATES 
ABNORMALLY, THE SUBMITTER WILL RECEIVE A MESSAGE FROM THE 
SYSTEM 
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ABSENTEE COMMANDS 


enter abs request, ear (BATCH NEVER LOOKED LIKE THIS!) 
1 QUEUES A REQUEST FOR THE CREATION OF AN ABSENTEE PROCESS 


l USAGE: enter_abs request path {-control_args} 
ear weird.absin 
ear weird.absin -restart 
ear trans.absin -time "Friday 9pm" 


ear trans.absin -queue 1 -arguments add sum 
list_abs request, lar 
0 PRINTS INFORMATION ABOUT ABSENTEE REQUESTS 
0 USAGE: list_abs request {-control args} 

lar 


lar -q 1 


lar -all 
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ABSENTEE COMMANDS 


@® cancel abs request, car 
0 CANCELS AN ABSENTEE REQUEST WHICH IS STILL QUEUED 


) USAGE: cancel_abs request request_id {-control_args} 
car weird.absin 
car trans.absin -q 1 


ear -id 202008 


® answer 
0 PROVIDES PRESET ANSWER(S) TO QUESTION(S) ASKED BY A COMMAND 
1 PRIMARILY FOR USE IN ABSENTEE INPUT SEGMENTS 


] THE ANSWER IS PROVIDED AN UNLIMITED NUMBER OF TIMES UNLESS 
LIMITED BY THE -times CONTROL ARGUMENT 


1 UNUSED ANSWERS ARE IGNORED 


1 USAGE: answer ans {-control_args} command line 
answer yes delete_dir Dir A 
answer yes -times 2 help send message 
answer rest help trace 


answer no answer yes -times 2 help trace 


17-8 | | FO1 


AREAS FOR ADDITIONAL STUDY 


@ ADDITIONAL DOCUMENTATION 
] MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 


1 help enter_abs_ request 


@ STUDY TOPICS 


1 CONTROL ARGUMENTS 


J -output_file, -limit, -brief — 


) ABORTING OF AN ACTIVE ABSENTEE PROCESS (THERE IS NO "GRACEFUL" 
WAY) 


0 DELETE ACCESS TO THE absin SEGMENT 
I DELETE ACCESS TO THE absout SEGMENT 


1 CALL OPERATOR 


] SELF PERPETUATING ABSENTEE PROCESSES 
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TOPIC XVIII 


SOFTWARE CONVENTIONS 


Command Language Special Symbols 
Segment Name Suffixes . , 
Suffix Convention ..... 
Canonical Form ...... 
set_tty Command ..... 


Page 


18-1 
18-7 
18-9 
18--10 
18-12 


FO1 


This page has intentionally 
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COMMAND LANGUAGE SPECIAL SYMBOLS 


(PERIOD) 


SEPARATES COMPONENTS OF AN ENTRYNAME, STAR NAME, OR ACCESS 


IDENTIFIER 


A_test.alpha.cobol 
#* lt 
Student 04.F01.m 


__ (UNDERSCORE) 


SIMULATES A SPACE FOR READABILITY IN ENTRYNAMES 


ran_num_gen.basic 
IS NOT AN ABBREV BREAK CHARACTER 


ALL SYSTEM SUBROUTINES END IN _ 


(GREATER-THAN) 
DENOTES HIERARCHY LEVEL (TOP DOWN) 


SEPARATES THE ENTRYNAMES IN A PATHNAME 


2udd>F01>Student_01>tools>my editor.pl1 
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COMMAND LANGUAGE SPECIAL SYMBOLS 


< (LESS-THAN) 
0 INDICATES ONE LEVEL BACK UP IN THE HIERARCHY 


1 EXAMPLES ASSUMING WORKING DIRECTORY IS >udd>FED>LJones>tools 


cwd < | 
ewd >udd>FED>LJones 


ewd << 
cwd >udd>FED 


pr <start up.ec 
pr >udd>FED>LJones>start _up.ec 


| pr <<TSmith>tools>random 
pr >udd>FED>TSmith>tools>random 


* (STAR OR ASTERISK) 


1 MATCHES ANY COMPONENT OF AN ENTRYNAME OR ACCESS IDENTIFIER 
(STAR CONVENTION) 


list seg 1.*.* 
list seg 1.** 


sa *.# r LJones.*.a 
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COMMAND LANGUAGE SPECIAL SYMBOLS 


@ ? (QUESTION MARK) 


! 4 


MATCHES ANY 
CONVENTION) 


LETTER OF A 


COMPONENT OF AN ENTRYNAME (STAR 


list s???.old.pl1 
list s??.#* 


(EQUAL) 


IS REPLACED BY THE CORRESPONDING COMPONENT OF AN ENTRYNAME 


(EQUAL CONVENTION) 


* (STAR) AND = 
rename 
rename 


rename 
rename 


rename 
rename 


rename 
rename 


add_name 
add_name 


(EQUAL) ARE SYMMETRICAL IN MEANING 


ordered.=.= 
ordered.gen.plt 


random.gen.pli1 
random.gen.pl1 


random.data.base -=.=: 
random.data.base random.data 


beta my _=.old 

beta my beta.old 

#* .new.pli =,0ld.= 

beta.new.plil beta.old.pli 
## ec s=.absin 
pll_pr.ec pli_pr.absin 
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COMMAND LANGUAGE SPECIAL SYMBOLS 


% (PERCENT) 


Il IS REPLACED BY THE CORRESPONDING CHARACTER OF A COMPONENT NAME 
(EQUAL CONVENTION) 


1 ? (QUESTION MARK) AND % (PERCENT) ARE SYMMETRICAL IN MEANING 


rename my old ed.pl1 %24new%22.= 
rename my old_ed.pl1 my_new_ed.pli 


rename 2772*,.data 2hb.= 
rename alpha 2.data alp.data 


; (SEMI-COLON) 


1 USED TO SEPARATE MULTIPLE COMMANDS IN A COMMAND LINE 


ewd dir_a; list; cwd dir _b;ls 


- (MINUS SIGN) 


2 IDENTIFIES CONTROL ARGUMENTS 


list -directory 


dprint -he TSmith -ds MS106 
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COMMAND LANGUAGE SPECIAL SYMBOLS 


@e ( ) (PARENTHESES) 


J CAUSES COMMAND ITERATION 


print (A B add).pl1 


print A.pl1 
print B.plt 
print add.pli 


sm Student _0(1 3 5).F01 Return to the classroom. 


sm Student _01.F01 Return to the classroom. 
sm Student 03.F01 Return to the classroom. 
sm Student _05.F01 Return to the classroom. 


rename (A B add).pl1 (a b Add).pl1 


rename A.pli a.pli 
rename B.pll b.plt 
rename add.pl1 Add.pli 


create dir (new>(first second) old>third) 
create dir new>first 


create dir new>second 
create dir old>third 
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COMMAND LANGUAGE SPECIAL SYMBOLS 


@ [ ] (BRACKETS) 


0 DELIMITS ACTIVE STRINGS. (EVALUATED BY ACTIVE FUNCTIONS) 


sm [last_message_ sender] Thanks! 


@ $ (DOLLAR SIGN) 


1 SEPARATES THE ENTRYNAME OF AN OBJECT SEGMENT FROM THE ENTRY 
POINT NAME WITHIN THE OBJECT SEGMENT 


l DEFAULT ENTRY POINT NAME IS THE ENTRYNAME 


add 
add$add 


add$max 
add$max 


@ " (QUOTES) 


J SUPPRESSES THE SPECIAL MEANING OF COMMAND LANGUAGE SPECIAL 


SYMBOLS 
rename ";" foo (segment name is: ;) 
delete "A B" (segment name is: A B) 
delete "ANNp (segment name is: A"B) 
delete A"™"B (segment name is: AB) 
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absin 


absout 


acs 

alm 

apl 
archive 
basic 
bind 
breaks 


emdb 
cmdsm 


cobol 
code 
compin 
compout 


dict 
dsm 


ec 
fortran 
gcos 
info 


iodt 


SEGMENT NAME SUFFIXES 


ABSENTEE INPUT SEGMENT FOR THE enter abs request COMMAND 


ABSENTEE OUTPUT SEGMENT CREATED VIA THE 
COMMAND 


_enter_abs request 
ACCESS CONTROL SEGMENT USEFUL TO THE IO DAEMON 

ALM SOURCE SEGMENT 

APL WORKSPACE SEGMENT 

SEGMENT MANIPULATED BY THE archive COMMAND 

BASIC SOURCE SEGMENT 

BINDFILE FOR THE bind COMMAND 

BREAK SEGMENT USED BY THE debug COMMAND 


MRDS DATA MODEL SOURCE 
COMMAND 


SEGMENT FOR THE create mrds db 


\ 


MRDS DATA SUB-MODEL SOURCE SEGMENT FOR THE create mrds dsm 
COMMAND 


COBOL SOURCE SEGMENT 

ENCIPHERED SEGMENT CREATED BY THE encode COMMAND 
INPUT SEGMENT TO THE compose COMMAND 

OUTPUT SEGMENT CREATED BY THE compose COMMAND 


WORDPRO DICTIONARY SEGMENT CREATED BY.THE 


add dict words 
COMMAND 


MRDS DATA SUB-MODEL SEGMENT CREATED BY THE create mrds_ dsm 
COMMAND 


COMMAND FILE FOR THE exec_com COMMAND 
FORTRAN SOURCE SEGMENT 
SEGMENT IN GCOS STANDARD SYSTEM FORMAT FOR THE gcos COMMAND 


SEGMENT FORMATTED FOR USE BY THE help COMMAND 
I/O DEVICE TABLE 
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linus 
list 


lister 


listform 


listin 
mbx 
memo 


motd 


mrpg 


ms 

pli 
profile 
gedx 


symbols 


wl 


SEGMENT NAME SUFFIXES 


LINUS MACRO SEGMENT FOR THE LINUS invoke REQUEST 

LISTING SEGMENT CREATED BY A LANGUAGE PROCESSOR 

LISTER DATA FILE (STRUCTURED) FOR THE process list COMMAND 
LISTER FORMS DESCRIPTOR SEGMENT FOR THE process list COMMAND 
LISTER DATA FILE (ASCII) FOR THE create list COMMAND 

MAILBOX SEGMENT FOR THE mail COMMAND 

DATA SEGMENT FOR THE memo COMMAND | 


DATA SEGMENT FOR THE print _motd COMMAND 


SOURCE SEGMENT FOR THE MULTICS REPORT PROGRAM GENERATOR'S 
mrpg COMMAND 


MESSAGE SEGMENTS FOR RJE 

PL/1 SOURCE SEGMENT | 

DICTIONARY SEGMENT FOR THE ABBREV PROCESSOR 
MACRO SEGMENT FOR THE qedx TEXT EDITOR 


SPEEDTYPE SYMBOL 


DICTIONARY CREATED BY THE 
COMMAND | 


add_symbol 


WORDPRO WORDLIST SEGMENT CREATED BY THE 


create wordlist 
COMMAND 
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SUFFIX CONVENTION 


@ ALL COMMANDS WHICH ONLY WORK ON SEGMENTS HAVING A GIVEN SUFFIX 
WILL APPEND THAT SUFFIX TO ENTRYNAMES TYPED WITHOUT THE SUFFIX 


archive a Field work summary report 
archive a Field work.archive summary report 


basic ran_num_gen -list 
basic ran_num_gen.basic -list 


cancel abs request weird 
cancel abs request weird.absin 


cobol A_alpha 
cobol A_alpha.cobol 


enter_abs request weird -tm 6pm 
enter_abs request weird.absin -tm 6pm 


exec _com A create add sum. 
exec com A_create.ec add sum 


fortran array dot 
fortran array dot.fortran 


indent add 
indent add.pl1 


pl1l add -optimize 
pl1 add.pli -optimize 
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pine” 


CANONICAL FORM 


MOTIVATION 


1 HOW WAS THE FOLLOWING LINE TYPED? 


The only one! 


The onlyBBBB one! 


a oB nB 1B yB_ one! 
o 6 OF = | 


The _Bo Bn Bl By one! 


COMPARISON OF TWO INTERNAL LINES SHOULD BE BASED ON RESULTING. 
PRINTED IMAGE 


THEREFORE, ALL INPUT SHOULD BE CONVERTED TO A_ STANDARD 
(CANONICAL) FORM 


MULTICS AUTOMATICALLY TRANSLATES ALL TERMINAL INPUT TO 
CANONICAL FORM (UNLESS THE USER REQUESTS OTHERWISE) 


SHOULD THE USER NOTICE THAT SOME TEXT IS NOT STORED IN THE SAME 
SEQUENCE AS IT WAS TYPED, CANONICALIZATION SHOULD BE EXPECTED 
(FOR EXAMPLE, DURING CERTAIN TEXT EDITING OPERATIONS) 
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CANONICAL FORM 


@ CANONICAL FORM 


1 OVERSTRIKES ARE STORED IN ASCENDING ASCII ORDER, SEPARATED BY 
THE BACKSPACE CHARACTER 


1 EXAMPLES: (B = BACKSPACE, C = CARRIAGE RETURN, N = NEWLINE) 


TYPIST: >B<B_ _B<B> 

TYPED LINE: ke ¥ 

CANONICAL FORM: <B>B_ <B>B_ 
TYPIST: The onlyBBBB 

TYPED LINE: The only 

CANONICAL FORM: The _Bo Bn_ Bl By 
TYPIST: _ We see no prob BlemC_N 
TYPED LINE: We see no problem 
CANONICAL FORM: WB Be see no problem 
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SET TTY COMMAND 


@ TERMINAL TYPES 
j MULTICS ATTEMPTS TO RECOGNIZE TERMINAL TYPE AT DIAL-UP TIME 
| EACH TERMINAL TYPE HAS A SET OF DEFAULT I/0 MODES 


1 TERMINAL I/O MODES AFFECT CHARACTER CONVERSION, DELAY TIMES, 
AND COMMUNICATION LINE CONTROL 


@ set _tty,ystty 


MODIFIES TERMINAL TYPE ei MODES ASSOCIATED WITH TERMINAL 
1/0 


J USAGE: set tty -control_args 
stty -terminal type TN300 
stty -ttp ARDS 


stty -ttp ti745 Oe 

Stty -ttp rosyt- 

stty ~nodes lfecho ,fulldpx tS 
stty-print hp farneloater of . 

stty ao 

atty Cdelay 1,0,0,0,0,0> yee 2 ~y, a ia Ze" eel a form 


Cte ae 


stty ae AB) 


. afl ag: F 
< ee) ; A ALE 
Vaaee Lp faegyy I & ar 
Cc / 2 ft ba nthe - 
; Ae Aw =F 
Lb et OS 


neteren 
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SET TTY COMMAND 


fe 


; : 
it we fpr” 
TERMINAL I/0 MODES ie ee 


‘as fi 
, | : 
“ ’ 
2 | “WwW” 
o ; 


= 


) can, “ean 


PERFORMS STANDARD CANONICALIZATION (DEFAULT IS OND 


J capo, “capo 


f OUTPUTS ALL LOWERCASE LETTERS IN UPPERCASE EFAULT IS OFF) 


f ECHOES AND INSERTS A LINE FEED IN-THE—USER'S INPUT STREAM 
WHEN A CARRIAGE RETURN IS TYPED((DEFAULT IS OFF) 


l crecho, “crecho 


‘sere tae 


J ECHOES A CARRIAGE RETURN WHEN A.LINE FEED IS TYPEDC(DEFAULT 
2 


) fulldpx, *fulldpx 
) ALLOWS TERMINAL TO RECEIVE AND TRANSMIT SIMULTANEOUSLY 


DEF AU 


1 echoplex, “echoplex 


0 ECHOES ALL CHARACTERS TYPED ON THE TERMINAL DEFAULT IS OFE) 
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SET TTY COMMAND 


I edited, “edited 


0 SUPPRE PRINTING OF UNPRINTABLE CHARACTERS - LIKE \O14 


DEFAULT IS OFF} 
i( +20) “tab pest Fi Le ot) 


ee eg nen PAO RC 


J INSERTS TABS IN. OUTPUT IN PLACE OF SPACES WHEN APPROPRIATE 
(DEFAULT IS OFF), 


) tabecho, “tabecho 


i ECHOES THE APF R NUMBER OF SPACES WHEN A HORIZONTAL 
TAB IS TY PED ( (DEFAULT 1 Is OFF); 
polite, “polite 


DOES NOT SEND OUTPUT TO RMINAL UNTIL THE CARRIAGE IS 
AT THE LEFT MARGIN (DEFAULT IS OFF)) ~ 


§ replay, “replay 


0 REPRINTS A} INPUT LINE THAT IS INTERRUPTED BY 
OUTPUT. ((DEFAULT IS OFF); 


YOU ARE NOW means FOR WORKSHOP 
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TOPIC XIX 


ADDITIONAL COMMANDS 


Access to the System 


Storage System, Segment Contents” 


Storage System, Manipulation 
Formatted Output Facilities 
Performance Monitoring 
Debugging... . ‘ 
Command Level Environment 
Accounting .. ; 
Absentee Computations 
Miscellaneous Tools . 
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ACCESS TO THE SYSTEM 


dial, d 


\ 
0 CONNECTS AN ADDITIONAL TERMINAL TO AN EXISTING PROCESS 


1 ANSWERING SERVICE SEARCHES FOR A LOGGED IN PROCESS HAVING THE 
SPECIFIED Person_id AND Project _id THAT IS ACCEPTING DIAL-UPS 


] SEE THE dial_manager_ SUBROUTINE DESCRIPTION (AK92) FOR MORE 
INFORMATION 


USAGE: dial dial_id Person_id.Project_id 


d 411 TransProc.HSD 


enter, e 
enterp, ep 


1 CONNECTS AN ANONYMOUS USER TO THE SYSTEM 


THE enter REQUEST DOES NOT ASK FOR A PASSWORD WHEREAS enterp 
DOES | 


i USAGE: enter {anonymous name} Project _id 
enterp {anonymous_name} Project _id 
e JDoe FED 


ep JDoe FED 
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ACCESS TO THE SYSTEM 


f USED TO GAIN ACCESS TO THE SYSTEM 


J USAGE: login Person_id {Project_id} {control_args} 
login TSmith 
login TSmith FO1 -cpw -ns. -modes lfecho 
login TSmith FO1 -gpw -cdp -ring 5 
login TSmith -force -hd >udd>FED>Kerr 


0 TERMINATES A USER SESSION 


f USAGE: logout {-control_ args} 
logout. -bf 
Neer oe 


logout -hold 
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ACCESS TO THE SYSTEM 


TELLS MULTICS THAT THE TERMINAL IS AN UPPERCASE-ONLY TERMINAL 


MUST BE INVOKED BEFORE THE ACCESS REQUEST (e.g., login) 
(PREACCESS ONLY) 


ALL INPUT IS MAPPED TO LOWERCASE EXCEPT FOR CHARACTERS PRECEDED 
BY A \ (BACKSLASH) 


2 USAGE: MAP 


— ee 


#029 AND 963 > 


} TELLS MULTICS THAT THE TERMINAL IS AN EBCDIC OR IBM 2741 
bes | co 


w MUST BE INVOKED BEFORE THE ACCESS REQUEST (e.g., login) 


1 USAGE: 029 -OR- 963 
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ACCESS‘TO THE SYSTEM 


a, 


@ sane > 
@® hello 


#i causes THE GREETING MESSAGE TO BE REPEATED 
yp” must BE INVOKED BEFORE THE ACCESS REQUEST (e.g. login) 


WSEFUL IF THE GREETING WAS GARBLED (AS WOULD OCCUR WITH AN 
“ EBCDIC TERMINAL OR BECAUSE OF LINE NOISE) 


4 USAGE: hello 
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STORAGE SYSTEM, SEGMENT CONTENTS 


® edm 


0 INVOKES A SIMPLE, INEXPENSIVE TEXT EDITOR (A SUBSYSTEM) 


J USAGE: edm {path} 
| edm 


edm add.pli 


1 INVOKES A SOPHISTICATED TEXT EDITOR (A SUBSYSTEM) HAVING MACRO 


CAPABILITIES 
1 USAGE 1: qedx 
(MANUAL EDITING) 
qx 
0 USAGE 2: — qedx path {optional args} 


(MACRO EDITING) 
qx conv_ft.qedx Random.fortran 
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STORAGE SYSTEM, SEGMENT CONTENTS 


archive, ac \ (LIKE SARDINES) 


COMBINES AN ARBITRARY NUMBER OF SEPARATE SEGMENTS INTO ONE 
SEGMENT (THE ARCHIVE SEGMENT) 


0 A MEANS OF ORGANIZING SEGMENTS (IDENTITY OF EACH SEGMENT IS 
PRESERVED ) 


ik SAVES PHYSICAL SPACE BY COMPACTING SEGMENTS TOGETHER 
| THE ARCHIVE SEGMENT MUST HAVE A SUFFIX OF archive 


0 CONSTITUENT SEGMENTS ARE CALLED COMPONENTS OF THE ARCHIVF 
SEGMENT 


fl THE COMMAND IS ALSO USED TO EXTRACT COMPONENTS FROM THE ARCHIVE 
AND RETURN THEM TO INDIVIDUAL STORAGE SYSTEM SEGMENTS 


Ay { z2 3 d . 
ci USAGE: archive key path components 


ac r bound pli _prgms.s add.pl1 sub.p11 
ac rd bound pl1 prems.s [segs *#spli) 
ac x bound pli_prgms.s.archive sub.pl1 
ac t bound pli prgms.s 

ac d bound _pli_prgms.s add.pl1 


19~6 FO1 


STORAGE SYSTEM, SEGMENT CONTENTS 


KEY 

I TABLE OF CONTENTS OPERATION (t, tl, tb, tlb) 
l APPEND OPERATION (a, ad, adf, ca, cad, cadf) 
0 REPLACE OPERATION (r, rd, rdf, er, erd, erdf) 
0 UPDATE peeRitaoy Cu; ud, udf, cu, cud, cudf) 
0 ‘DELETE OPERATION (d, cd) 

0 EXTRACT OPERATION (x, xf) 


ed 


oe 


fig cat 


X.archive | 
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STORAGE SYSTEM, SEGMENT CONTENTS 


fo sia hs AND THEY SHALL BECOME AS ONE) 


PRODUCES A SINGLE BOUND (PRE-LINKED) OBJECT SEGMENT FROM ONE OR 
MORE UNBOUND OBJECT SEGMENTS | 


1 THE OBJECT SEGMENTS TO BE BOUND MUST FIRST BE PLACED IN AN 
ARCHIVE SEGMENT 


1 THE CONTENTS OF THE ARCHIVE SEGMENT ARE THEN "BOUND" TOGETHER 


l USAGE: bind paths {-control args} 


bd editor _mods.archive 


Le ee 


bind 


bound_ABC.archive bound_ABC 


bd bound_ABC 
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‘STORAGE SYSTEM, SEGMENT CONTENTS 


@® compare ascii, cpa 


0 


COMPARES TWO ASCII SEGMENTS AND PRINTS THE CHANGES MADE TO THE 
CONTENTS OF PATH1 TO YIELD THE CONTENTS OF PATH2 


| THE AMOUNT OF LOOK AHEAD FOR RE-SYNCHRONIZING IS DETERMINED BY 


THE min_chars sii min_ lines ARGUMENTS 
DEFAULT min_chars IS 50, DEFAULT min_lines IS 5 


USAGE: compare ascii path1 path2 {min_chars} {min_lines} 


cpa genum.old.pli genum.new.pli1 


aw 


@ adjust_bit_coun sae, 


r 


CORRECTS THE BIT COUNT OF A SEGMENT (AN ATTRIBUTE STORED IN THE 
CONTAINING DIRECTORY) TO REFLECT THE ACTUAL BIT COUNT OF THE 
SEGMENT 


USEFUL ON FILES - BEry IN AN INCONSISTENT STATE (BY AN ABORTING 
PROGRAM, ETC) 


USAGE: adjust_bit_count path {-control_ args} 
abe temp 


abe output file -lg 
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STORAGE SYSTEM, MANIPULATION 


@® link, 1k (DON'T CONFUSE WITH DYNAMIC LINKING) 
0 CREATES A LINK TO A SPECIFIED SEGMENT OR DIRECTORY 
l THE LINK "LOOKS" LIKE THE REAL THING TO MOST COMMANDS 


J] USED TO SAVE PHYSICAL SPACE AND/OR REDIRECT STORAGE SYSTEM 
ACCESSES 


1 FREQUENTLY USED BY A PERSON BELONGING TO SEVERAL PROJECTS TO 
LINK HIMSELF TO A COMMON MAILBOX, start_up.ec, profile, etc. 


) USAGE: link path, {path2) 
1k >udd>FEDKerr>dev>x_sort >udd>FED>Kerr>tools>sort 
lk >udd>FED>Kerr>dev>x_sort sort | 
1k >udd>FED>Kerr>dev>x_sort 
lk (home_dir]>({Csegs[home_dir]>**]) 
@® unlink, ul 


0 DELETES THE SPECIFIED LINK ENTRY 


J USAGE: unlink paths 


ul sort 
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LL-6L 


LOd 


LINKING EXAMPLE 1 


Student_07 


link >udd>FO1> Student.07>add add_7 


link >udd>F01>Student_07>seg_ 2 


NOILVINdINVN W3ISAS FOVYOLS 


LINKING EXAMPLE 2 


r----- 


NOILV'INdINVA WALSAS JDVHOLS 


start up.ec Lyon .mbx Gon) 
! 
i | ‘ | 
I t ‘ ee | 
] t ‘ i 
i a eek ey ee he, ea 
t 
4 Me ps aces ae ec a a acs Sas ce ees ee ee ee Ge as “ee J 
[Torsmits 
home directory 


link >udd»>MMPP?Lyon>(start_up.ec Lyon.rnbx) 
link »udd>MMPP Lyon Pat 
link »udd»WOPS >TSmith Tor 


FORMATTED OUTPUT FACILITIES 


Pa 


® cunp_segnent, (as) 


0 PRINTS A SEGMENT'S CONTENTS IN OCTAL, ASCII, OR BCD 
> 


) USAGE: dump segment path {first} {n_words} {-control_ args} 
ds prince 400 20 


ds add -bed 


ating, 


sR 


a 
® sort seg, ss | 


/ 


“ 
é 


1 ORDERS THE CONTENTS OF A SEGMENT ACCORDING TO THE ASCII 
COLLATING SEQUENCE | | 


1 SEGMENT IS. BROKEN DOWN INTO SEPARATE SORT UNITS DELIMITED BY 
SPECIFIED DELIMITER STRING. SORT UNITS ARE THEN SORTED 


1 USAGE: sort_seg path {-control_args} 
ss tel _data.old 
ss tel_data.old -delimiter xx -descending 


ss tel_data.old -sm tel_data.new -unique 
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PERFORMANCE MONITORING 


cumulative page trace, cpt 


0 ACCUMULATES PAGE TRACE DATA SO THAT THE TOTAL SET OF PAGES USED 
FOR: A COMMAND OR PROGRAM CAN BE DETERMINED 


0 USAGE: cumulative page trace command_line {-control args} 
ept add -reset 
ept -print 


0 PRINTS INFORMATION ABOUT THE EXECUTION OF INDIVIDUAL STATEMENT: 
WITHIN A PL/I, FORTRAN, OR COBOL PROGRAM 


1 PROGRAMS MUST HAVE BEEN COMPILED WITH THE -profile CONTROL 
ARGUMENT 


0 USAGE: profile path {-control_args} 
profile add 


profile add ~reset 
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@® trace_stack, ts 
f PRINTS THE USER'S STACK HISTORY -. MOST RECENT FIRST 
) USAGE: trace_stack {-control_args} 
ts 
ts -depth 5 
® trace 
1 MONITORS CALLS TO SPECIFIED PROCEDURES 


l PROCEDURES MUST HAVE ORIGINATED FROM PL/I OR FORTRAN SOURCE 


J USAGE: trace {-control_args} names 


trace add 
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COMMAND LEVEL ENVIRONMENT 


‘ 
\ 


a i 
i 
line_length, 11 / 


0 SETS THE MAXIMUM LENGTH OF OUTPUT LINES 


) WRAP-AROUND, IF IT OCCURS, IS PRECEDED BY "\c" 


0 USAGE: line length maxlength 
11 118 


ready off, rdf 
0 TURNS OFF THE READY MESSAGE 
J USAGE: ready off 

rdf 


ready on, rdn 


0 PRINTS A READY MESSAGE AFTER 
PROCESSED (THE DEFAULT) 


[ USAGE: ready on 


rdn 
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EACH COMMAND LINE HAS BEEN 


FO1 


COMMAND LEVEL ENVIRONMENT 


a 


WALLOWS USER TO FORMAT THE READY MESSAGE 


1 USAGE: general ready {-control_ arg} 
| gr -string "DONE MASTER" -set 
gr -string * -call print messages -set 
gr -string READY -hour : “minute -inc_ cost 


gr -control * ~-set 
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ACCOUNTING 


@ get_quota, gq 


0 RETURNS INFORMATION ABOUT STORAGE QUOTA AND USAGE FOR A 
SPECIFIED DIRECTORY , 


9 DOES NOT "get" THE USER ANY MORE QUOTA 
J USAGE: get_quota {paths} {-control_ args} 


gq dir_A 
6q -long 


® resource usa - ru i; 
* Vee 


0 PRINTS A REPORT OF RESOURCE CONSUMPTION FOR THE CURRENT BILLING 
PERIOD 


USAGE: resource_usage {-control_ args} 


ru 


ru -long 
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ABSENTEE COMPUTATIONS 


& er 


. SUBMITS AN ABSENTEE REQUEST TO PERFORM FORTRAN COMPILATIONS AND 
- dprint COMPILER'S OUTPUT 


l USAGE: fortran_abs paths {-ft_args} {-dp args} {-abs args} 


fa array dot.fortran 


fa array dot -map -copy 2 
Pe \ 
@ pli_abs, o 


0 SUBMITS AN ABSENTEE REQUEST TO PERFORM PL/I COMPILATIONS AND 
dprint COMPILER'S OUTPUT 


USAGE: pli_abs paths {-pl1_args} {-dp_ args} {-abs args} | 
pa add.pll 


pa add -optimize -queue 1 -hold 
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ABSENTEE COMPUTATIONS 


aan tli om 


—— 
@ runoff abs, rfa / 


“a 
ao 


0 SUBMITS AN ABSENTEE REQUEST TO PROCESS TEXT SEGMENTS (USING THE 
RUNOFF COMMAND) AND dprint THE OUTPUT 


§ USAGE: runoff_abs path {-rf_args} {-ear_args} {-dp_args} {-abs. 
rfa prince.runoff | 


rfa prince -in 10 -tm 8pm -cp 3 


@ cobol_abs 


0 SUBMITS AN ABSENTEE REQUEST TO PERFORM COBOL COMPILATIONS AND 
dprint COMPILER'S OUTPUT 


f USAGE: cobol_abs paths {cobol_args} {dp args} {-abs_ args} 


ca add.cobol 


ca add -optimize -queue 1 -hold 
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MISCELLANEOUS TOOLS 


ROVIDE THE USER WITH A CALCULATOR (A SUBSYSTEM) 
0 ACCEPTS FORTRAN-LIKE EXPRESSIONS 
0 pi AND oak BUILT-IN VARIABLES 
l USAGE: cale 


x=pi * 3.4 ## 2 . 
3.57 * 2*#(x * 10.7)/sin (35.7) 


NN 
* encode 


0 ENCIPHERS A SEGMENT'S CONTENT ACCORDING TO A KEY SUPPLIED BY 
THE USER 


f encode ASKS TWO TIMES FOR THE ENCIPHER KEYWORD 
f ENCIPHERED SEGMENT IS GIVEN A SUFFIX OF code 
0 USAGE: encode pathi {path2} 


encode blacklist 
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MISCELLANEOUS TOOLS 


@ decode 


0 RECONSTRUCTS AN ORIGINAL SEGMENT FROM AN ENCIPHERED SEGMENT IF 


PROPER KEY IS SUPPLIED 


) decode ASKS FOR THE ENCIPHER KEYWORD 


USAGE: decode path1 {path2} 
decode blacklist 
® new proce 
0 DESTROYS THE USER'S CURRENT PROCESS AND CREATES A NEW ONE 
) EFFECTIVELY THE SAME AS LOGGING OUT AND LOGGING IN AGAIN 
J ASSUMES THE SAME CONTROL ARGUMENTS THE USER GAVE AT LOG IN 


1 USAGE: new_proc {-control_ arg} 


new_proc 


YOU ARE NOW READY FOR WORKSHOP 
#9 
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TOPIC XxX 


SOFTWARE OVERVIEW 


The Operating System ..... «2. 6 © «© © © © © © © © 2 2 20—4 
SVSCeM "S@CUPrLEY hse 5> Kh ek ees EP ae OS. See ae Ha es A a ew a 202 
Ring: MeGRAni Sis 26 ik) se. oh cee os vee ee See ee 8? ae ee es 
System Daemons. . BGs. ie er SM ee We ee we, er OSD 
System Libraries and “Directories” « 
Application Packages ......4.-. 
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THE OPERATING SYSTEM 


MORE THAN 95% OF THE OBJECT CODE ORIGINATED FROM PL/E SOURCE 
(1,132,000 LINES) , 


LESS THAN 5% OF THE OBJECT CODE ORIGINATED FROM ALM ASSEMBLY CODE 
(226,000 LINES) 


TOTAL OBJECT CODE OCCUPIES MORE THAN SIX MILLION WORDS OF STOR’ .* 


HIGHLY STRUCTURED (3300 MODULES) 


CODE IS PURE, RECURSIVE AND RE-ENTRANT 


ON-LINE INSTALLATION OF SYSTEM MODULES 


EXTENSIVE ON-LINE METERING AND TUNING FACILITIES 


DOA FOI 


SYSTEM SECURITY 


"., Multics is properly characterized as the most secure 
commercial operating system available." 


Prof. Peter J. Denning 

Computer Science Dept. 

Purdue University | 
(Computing Europe, July 29, 1976) 


Multics security architecture is Superior to any other 
commercially available system (by 2 to 1 ratio). © 


Mitre Corporation Study for 
U.S. Air Force - Sept., 1975 
(USDC Order No: AD-A009221). 


SYSTEM ACCESS: USER AUTHENTICATION 
l USER AUTHENTICATION REQUIRED TO LOG IN 


I PASSWORD IS DETERMINED AND CHANGED BY USER, AT WILL (RANDOM 
PASSWORD GENERATION IS AVAILABLE IF DESIRED) 


1 ONLY A NON~-REVERSIBLE RESIDUE OF EACH PASSWORD IS STORED 
9 NOTIFICATION OF INCORRECT PASSWORD USAGE 


1 LAST LOG IN NOTIFICATION 
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SYSTEM SECURITY 


VIRTUAL MEMORY 
l INVISIBLE ABSOLUTE MEMORY ADDRESSES 
1 ADDRESS SPACE UNIQUE TO PROCESS 


I RESIDUE CLEARED PRIOR TO PAGE ALLOCATION 


FILE AND PROGRAM ACCESS: ACL (DISCRETIONARY) 


ACL MECHANISM SEPARATES AND PROTECTS USERS FROM OTHER USERS ON 
THE BASIS OF Person_id AND Project_id 


2 EVERY SEGMENT AND DIRECTORY HAS AN ASSOCIATED ACCESS CONTROL 
LIST | 


1 ACL DETERMINES WHO MAY ACCESS A SEGMENT OR DIRECTORY AND HOW 
THEY MAY ACCESS IT 


1 AN ACL IS MANIPULATED AT THE DISCRETION OF THE SEGMENT'S OR 
DIRECTORY'S OWNER 
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SYSTEM SECURITY 


FILE AND PROGRAM ACCESS: AIM (NONDISCRETIONARY) 


AIM (ACCESS ISOLATION MECHANISM) MECHANISM SEPARATES AND 
PROTECTS USERS FROM OTHER USERS ON THE BASIS OF SECURITY LEVEL 
AND THE NEED TO KNOW 


EVERY SEGMENT, DIRECTORY AND USER HAS AN ASSIGNED SENSITIVITY 
(SECURITY) LEVEL AND CATEGORY SET 


AIM RESTRICTS SEGMENT AND DIRECTORY ACCESS TO USERS BELONGING 
TO THE SAME CATEGORY SET AND HAVING THE SAME, OR HIGHER, 
SENSITIVITY LEVEL 


SENSITIVITY LEVELS AND CATEGORY SETS ARE ASSIGNED BY THE SYSTEM 
ADMINISTRATOR (UP TO 8 LEVELS AND 18 CATEGORIES) 


USERS CANNOT "GIVE AWAY" ACCESS OR WRITE DATA INTO A LOWER 
SENSITIVITY LEVEL REGARDLESS OF ACL PERMISSIONS 


AIM IS A SITE CONTROLLED OPTION 
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SYSTEM SECURITY 


@ FILE AND PROGRAM ACCESS: RINGS (INTRAPROCESS) 


THE RING MECHANISM SEPARATES AND PROTECTS THE OPERATING SYSTEM | 
FROM THE USERS 


) THE RING STRUCTURE IS AN 8 LEVEL (0 THRU 7) 
MASTER-MODE/SLAVE-MODE HIERARCHY 


I 0 = CENTRAL SUPERVISOR (MOST PRIVILEGED) 
l 1 - SYSTEM ROUTINES 
I 4 - NORMAL USER RING 


1 7 - HIGHEST USER RING (LEAST PRIVILEGED) 
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- SYSTEM SECURITY 


PERSONNEL_FILE 1. 
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SYSTEM SECURITY 


EACH SEGMENT HAS AN ATTRIBUTE WHICH IS A SET OF INTEGERS KNOWN 
AS RING BRACKETS 


THE RING BRACKETS DEFINE FROM WHICH RING(S) A PROCESS MAY READ, 
WRITE, CALL, OR EXECUTE THAT SEGMENT 


‘EACH PROCESS IS CREATED IN A GIVEN RING DETERMINED AT LOGIN 


A PROCESS MAY TEMPORARILY CHANGE ITS RING OF EXECUTION BY 
EXECUTING A PROGRAM CALLED A GATE ec er te 


1 EXAMPLE: 
1 A DATA BASE IN A LOWER RING THAN A USER CAN ONLY BE 


ACCESSED BY THAT USER VIA AN OWNER WRITTEN "GATE" 
“PROCEDURE - REGARDLESS OF AIM AND ACL PERMISSIONS 


HARDWARE ENFORCED AT EVERY ACCESS 


20-7 FO1 


RING MECHANISM 


RING MECHANISM SUMMARY 


WRITE READ EXECUTE 
| WRITE 
BRACKET] | 
READ BRACKET 


ae 
BRACKET 


ia a 


L eae] 
BRACKET * 


RING OF EXECUTION 


: * SUBJECT, OF COURSE, TO ACL AND AIM 
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CORRESPONDING 
PERMITTED ACTION: 


READ, WRITE, 
EXECUTE (WITH RIN 
CHANGE) 


s READ, WRITE, AND 
; EXECUTE 


READ, EXECUTE 


EXECUTE (IF A GATI 
ONLY, AND WITH Ril 
CHANGE) 


FO1 


SYSTEM DAEMONS 


Daemon 


N A SYSTEM SERVICE PROCESS THAT PERFORMS A SPECIFIC TASK SUCH AS 
PROCESS CREATION, BACKUP, NETWORK CONTROL, PERIPHERAL 1/0 


1 LOGGED IN BY THE OPERATOR AND CANNOT "TIME OUT" AS A USER MIGHT 


Backup.SysDaemon 


0 A PROCESS DESIGNED TO PRODUCE BOTH INCREMENTAL AND CONSOLIDATED 
BACKUP COPIES OF THE STORAGE SYSTEM 


1 BACKUP IS TO MAGNETIC TAPE 


) SITE DETERMINES THE FREQUENCY OF THE BACKUPS 


Card Input.Daemon 


l A PROCESS DESIGNED TO MANAGE THE SYSTEM CARD READER(S) 


I0.SysDaemon 


0 A PROCESS DESIGNED TO MANAGE THE SYSTEM'S LINE PRINTERS AND 
CARD PUNCHES : 
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SYSTEM DAEMONS 


Dumper .SysDaemon 


0 A PROCESS DESIGNED TO PRODUCE A COMPLETE BACKUP OF THE STORAGE 
SYSTEM | 


GCOS.SysDaemon 


0 A PROCESS DESIGNED TO AID IN THE SIMULATION OF A _ GCOS 
ENVIRONMENT ON MULTICS 


J ALLOWS STANDARD GCOS JOBS TO BE SUBMITTED FROM EITHER PUNCHED 
CARDS OR IMCV TAPES 


Initializer.SysDaemon 


0 THE SYSTEM'S PRIMARY PROCESS. PERFORMS THE FOLLOWING 
FUNCTIONS: 


I ANSWERING SERVICE OPERATIONS (login, dial, logout, etc) 
1 OPERATOR COMMAND SERVICE 

OPERATOR TERMINAL MANAGEMENT AND MESSAGE ROUTING 
SYSTEM ACCOUNTING AND ADMINISTRATION 


J USER REQUEST HANDLING (logout, new_proc, etc) 
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"system. 
library _ 
auth _maint 


e COMMAND AND 
SUBROUTINES OF 
THE LOCAL 
AUTHOR-MENTION 
LIBRARY 


@ ted, lisp, pascal 


SYSTEM LIBRARIES AND DIRECTORIES 


ROOT | 


system _library_1 


system_library_ tools 
stl tools 


O00 


@ COMMANDS AND SUBROUTINES 
SUBROUTINES USED TO 
ADMINISTER, MEASURE, 

@ RELOADED EACH TIME AND MAINTAIN THE 
THE SYSTEM IS SYSTEM . 

REINITIALIZED 


system control 1 
_ $e 


@ PLUS MISCELLANEOUS ACCOUNTING, 
LOG, LINE USAGE, PASSWORD SEGMENTS 
AND THE i/O RESQURCE CONTROL . 
PACKAGES 


@ HARDCORE OPERATING 
SYSTEM PROCEDURES 


e@ PRIMARILY OF INTEREST 
TO SYSTEM PROGRAMMERS 
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03 


e ALL COMMANDS AND 
SUBROUTINES PROVIDED 
AS PART OF MULTICS 


ONE 
DIRECTORY 
PER PROCESS 


@ PLUS OTHER TEMPORARY SEGMENTS CREATED 
A$ HEEDED. 


user_dir_ dir 
udd 


(PROJECT NAME) 


(USER NAME) 


@ PERSONAL SEGMENTS 
AND DIRECTORIES 
OF THIS USER 


io LINUS, MRDS, MRPG 


ONE 
DIRECTORY 


PER PROJECT 


ONE 
DIRECTORY 
PER USER 


SSTNOLOIUIG ANY SSIYVHAIT WALSKS 


€L-02 


104 


system_library_ obsolete |} 


e CONTAINS OBSOLETE 
OBJECT SEGMENTS 


@ CONTAINS SYSTEM 
DUMPS FOR 
CRASHES, ETC. 


ROOT 


experimental . 
ext 


. @ CONTAINS SYSTEM e CONTAINS SYSTEM e CONTAINS OBJECT SEGMENTS 


SOFTWARE USEFUL SOFTWARE WHICH FOR NETWORK PROCESSING 
FOR HANDLING THE iS BEING DEVELOPED 
GCOS ENCAPSULATION 
e CONTAINS PROCEDURES 
BEING USED IN PLACE 
OF SYSTEM PROCEDURES 
WHICH ARE FAULTY 


RALSAS 


SAIYOLOaNIG GNV SHIYVHaTT 


SYSTEM LIBRARIES AND DIRECTORIES 


daemon _ documentation . | library dir_1 
dir_dir doc idd 


@ SEE NEXT P 


e CONTAINS THE FIRMWARE e DIRECTORIES AND 


REQUIRED BY VARIOUS SEGMENTS OF THE 
PERIPHERAL DEVICES BACKUP AND 1/0 
(i.e, TAPE AND DISK DAEMON PROCESS 
CONTROLLERS) 


e INFO SEGMENTS @ INSTALLATION @ OTHER USEFUL 
FOR THE heip MAINTAINED DOCUMENTATION 
COMMAND info SEGMENTS DIRECTORIES ANT 

SEGMENTS 
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library_dir_dir | 
tid 


ONE FOR EACH OF THE 
FOLLOWING: 
! systam_ library _ network 
system _ library _ obsolete 
* unbundled 


tools ; =n ees 
* communication : | 


* bos 
SzrOere@ 


* language 


NO 
oS 
. 
ak ~@ ALL PL/1 INCLUDE ; ' 
wn FILES CQO OOO OOOO 
e CONTAINS PL/1 LISTINGS 
FOR SYSTEM PROGRAMS 


e LOCATED ON A SEPARATE 
LOGICAL VOLUME WHICH 
"MAY BE REMOVED 


bound full cp archive @ CONTAINS 9 OtRECTORIES: 
; bos 
bound_ full_cp _.tist languages 
(bind listings) standard 
taols 

obsolete 
comm 
unbundied 
network 
-hardcore 


bound _full_cp_.s.archive 


* THESE CONTAIN ADDITIONAL DIRECTORIES 


Lod 


SSS = eemteennemesiaeh 
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APPLICATION PACKAGES 


@® MULTICS DATA BASE MANAGER (MDBM) 


1 MULTICS INTEGRATED DATA STORE (MIDS) 


SUPPORTS NETWORK DATA BASES 
A SUBSET OF IDS-II 


PROCEDURAL INTERFACE (USER SPECIFIES HOW TO SEARCH) 


 MULTICS RELATIONAL DATA STORE (MRDS) 


SUPPORTS RELATIONAL DATA BASES 
INDUSTRY'S FIRST COMMERCIALLY AVAILABLE RELATIONAL DBM 


NON-PROCEDURAL INTERFACE USING ENGLISH-LIKE EXPRESSIONS 
(USER SPECIFIES GOAL OF SEARCH) 


SET OPERATIONS ON RELATIONS (I.E. ON FILES): 
J UNION, INTERSECTION, DIFFERENCE 


BOOLEAN OPERATIONS BETWEEN CONDITIONS FOR SELECTION: 
1 AND, OR, NOT 


ALGEBRAIC COMPARISONS ON ATTRIBUTES (I.E. ON DATA FIELDS): 
0 EQUAL, GREATER THAN, LESS THAN, NOT 


BUILT~IN FUNCTIONS 


1 abs, after, before, ceil, concat, floor, index, mod, 
reverse, round, search, substr, verify 
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APPLICATION PACKAGES | 


LOGICAL INQUIRY AND UPDATE SYSTEM (LINUS) 
0 END USER FACILITY FOR ACCESSING RELATIONAL DATA BASES 


| ENGLISH-LIKE EXPRESSIONS 


l FIND THE AVERAGE SALARY OF EMPLOYEES IN THE SHOE DEPARTMENT 


avg {select salary 
| from employee table 
where dept = "Shoe"} 


0 BOOLEAN OPERATIONS BETWEEN CONDITIONS FOR SELECTION: 


1 AND, OR, NOT 


l ALGEBRAIC COMPARISONS ON ATTRIBUTES (I.E. ON DATA FIELDS): 
J EQUAL, GREATER THAN, LESS THAN, NOT 


0 FIND THE NAMES OF EMPLOYEES WHO ARE EITHER IN THE ADMIN 
DEPARTMENT OR WHOSE TOTAL INCOME EXCEEDS $10,000 


select name 


from employee _table . 
where dept = "Admin"| salar y+comm> 10000 
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APPLICATION PACKAGES 


1 SET OPERATIONS ON RELATIONS (I.E. ON FILES): 
0 UNION, INTERSECTION, DIFFERENCE 


FIND THOSE ITEMS WHICH ARE SUPPLIED BY LEVI AND SOLD IN THE 
MEN'S DEPARTMENT 


select item 

from supply 

where supplier = "Levi" 
inter 

select item 

from sales 

where dept = "Men" 


] BUILT-IN FUNCTIONS 


) abs, after, before, ceil, concat, floor, index, mod, reverse, ri 
search, substr, verify 


j max, min, sum, ave, count 


PERMITS USER DEF INABLE FUNCTIONS (I.E., MACROS) 
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APPLICATION PACKAGES 


@ MULTICS REPORT PROGRAM GENERATOR 


f A FACILITY FOR GENERATING FORMATTED REPORTS 


MRPG DATA 
SOURCE (USER 
(USER WRITTEN) | _ SUPPLIED) 


FORMATTED 
REPORT 


REPORT 
PROGRAM 


GENERATES 


CREATES 
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APPLICATION PACKAGES 


@ WORD PROCESSING (WORDPRO) 


A COLLECTION OF FACILITIES FOR ENHANCING THE ON-LINE pRerAnehron: 
DISTRIBUTION, AND MAINTENANCE OF DOCUMENTS 


1 CONSISTS OF SUCH TOOLS AS: 


1 SPEEDTYPE COMMANDS 
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APPLICATION PACKAGES 


J compose FACILITY 


chia {Title ff 


 WORDLIST COMMANDS 
] ELECTRONIC MAIL COMMANDS 


) TEXT EDITOR 
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APPLICATION PACKAGES 


f LIST PROCESSING COMMANDS 


20-22 | FO1 


APPLICATION PACKAGES 


ONLINE DICTIONARIES 


wordlist 
fred fred.wi 
(20,000 WORD (5,000 UNIQUE 
DOCUMENT) WORDS} 


TEXT COMPARISON PROGRAMS 


compare _ascii 
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fred.wi 
(100 POTENTIALLY 
MISSPELLED WORDS) 


Inserted in B: 

B1 Dear Mom: 
Preceding: 

Al Today we 
A3 large fish 
Changed by B to: 

B4 small fish 
AG Everest. 
Change by B to: 

B7 Punk. 


FO1 


APPLICATION PACKAGES 


® Multics GRAPHICS SYSTEM 


f DEVICE INDEPENDENCE 
' | USER SEES ONLY "VIRTUAL GRAPHICS TERMINAL" (VGT) 


) EACH DEVICE HAS A "GRAPHIC DEVICE TABLE" (GDT) 


j SIMPLE ITEMS (LIWES, POINTS) COMBINED TO CREATE MORE COMPLE) 


§ GRAPHIC OBJECTS MAY BE “SHARED® (EX. CREATE A WHEEL ONCE, 
INCLUDE 4% TIMES IN AN AUTOMOBILE STRUCTURE) 


1 ALL ITEMS ARE THREE DIMENSIONAL 
§ OBJECTS MAY BE NAMED 
| OBJECTS MAY BE PERMANENTLY STORED 


f ANCILLARY INFORMATION STORED WITH OBJECT 
1 SCALING 


§ ROTATION 
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APPLICATION PACKAGES 


) EXTENT 

) INTENSIT 

1 COLOR 

1 DOTTEDNESS 
1 BLINKING 


l SENSITIVITY TO LIGHT PENS, ETC. 
EDITING FACILITIES 
1 MAY EDIT THE WORKING GRAPHIC SEGMENT (WGS) 


f REAL TIME EDITING AT TERMINAL 


1 CONTROLLED BY Multics (ANIMATION, DYNAMIC GRAPHICS) 
PERMANENT STORAGE OF GRAPHIC OBJECTS 


TERMINALS SUPPORTED 


f TEKTRONIX 4002 
4012 
4013 
4014 
4015 
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APPLICATION PACKAGES 


f ARDS 


9 CALCOMP 915/1036 (PLOTTER) 


20-26 FO 


TOPIC XXI 


HARDWARE OVERVIEW 


Page 
Hardware Description ...... © « © © © © «© «© © «© «© « 211 


System Requirements ...- a ioe es Pa here Dow, eis Me Va ees 
Configuration Limits & Records fsa ee ee ae ee A er le el eS 
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HARDWARE DESCRIPTION 


LEVEL 68 CENTRAL PROCESSOR UNIT 


J A MODIFIED LEVEL 66 CPU 


i 
» 


1 36-BIT WORD MACHINE. (9 BITS/BYTE, 4 BYTES/WORD) 


1 VIRTUAL MEMORY HARDWARE 
1 DIVIDES MEMORY INTO SEGMENTS 
I SEGMENTS CONSIST OF 0 TO 256 PAGES 


f PAGE = 1024 WORDS (1K WORDS). 
1 RING PROTECTION HARDWARE 
1 ACCESS ENFORCING HARDWARE 


l HIGH-SPEED CACHE MEMORY 
1 2048 WORDS 


J HIT RATIO GREATER THAN 85% 
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FO1 


HARDWARE DESCRIPTION 


I EXTENDED INSTRUCTION SET (EIS) 
I BLOCK MOVE INSTRUCTION (ENTIRE SEGMENT) 
0 BOOLEAN OPERATION INSTRUCTIONS 
l PICTURE EDITING INSTRUCTIONS 
I 4, 6, OR 9-BIT ARITHMETIC INSTRUCTIONS 


f POINTER MANIPULATION INSTRUCTIONS 


I GCOS MODE (ONE SWITCH) 
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SYSTEM REQUIREMENTS 


SMALL MULTICS CONFIGURATION 


NUMBER 
68/60 CENTRAL PROCESSOR (CPU) 1 
WORDS OF MEMORY (K = 1024) 256K 
SYSTEM CONTROL UNIT (SCU) 1 
I/O MULTIPLEXER (IOM) | 1. 
FRONT-END NETWORK PROCESSOR (FNP) 1 
MSU0400 2 MASS STORAGE UNITS (MSU) 2 
MTUO4OO MAGNETIC TAPE UNITS (MTU) 2 
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SYSTEM REQUIREMENTS 


LARGE MULTICS CONFIGURATION (1 TO 10 GROWTH CAPABILITY) 


NUMBER 
68/80 CENTRAL PROCESSORS 6 
WORDS OF MEMORY (M=1,048,576) 16M 
SYSTEM CONTROL UNITS 8 


I/O MULTIPLEXER (# IOM'S + # CPU'S < 8) 2 


FRONT-END NETWORK PROCESSORS 4 

MSU0451 MASS STORE UNITS 512 

MTU0500 MAGNETIC TAPE UNITS 16 
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RATIO 


(1 


(1 


(1 


(1 


(1: 


76) 
:64) 
:8) 
:2) 


34) 


256) 


78) 
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CONFIGURATION LIMITS & RECORDS 


MEASURE RECORD SITE 
NUMBER 457 HIS, PHOENIX 
OF USERS (JUNE '77) 
NUMBER 6 AFDSC , PENTAGON 
OF CPU's (AUG '77) 

- MAXIMUM 4M HIS, Phoenix 
REAL MEMORY (SEPT '78) 
MINIMUM 192K HIS, CAMBRIDGE 
REAL MEMORY (1971 - 1977) 
VIRTUAL MEMORY 
PER PROCESS wee eitee as 
TOTAL VIRTUAL 
MEMORY wee eee eee 
NUMBER OF 28 AFDSC, PENTAGON 
DISK DRIVES (JAN '76) 

K = 2%**10 = 1,024 
M = 2**20 = 1,048 ,576 
B = 2**30 = 1,003,741,824 
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KNOWN LIMIT 


TOS 2 oes 
(408 USERS * 4 DATANETS) 


T 
(PORT LIMITATION) 


16M 
(8 SCU's * 512K) 


192K | 
(BOOT LIMITATION) 


256M 


(1024 SDW's * 256K) 


19.4B 
(512 MSU'S * 38,000K) 


512 
(CABLE LENGTH LIMIT) 


FO1 
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APPENDIX A 


MULTICS DOCUMENTATION | 


Multics Programmers' Manual (MPM) A 
Multies Pocket Guides: <c- @ He. oo aoe ow RS OER LS oR OS ee ws OTR 
Multics Administrators' Manuals (MAM) .......... =A- 
Program Logic Manuals (PLM) a A 
Other Multics Manuals ...... A 
help Manuals ......2.-. A 
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MULTICS PROGRAMMERS' MANUAL (MPM) 


Reference Guide Order No. AG9Q1 


The MPM Reference Guide contains general information about the 
Multics command and programming environments. It aiso defines 
items used throughout the rest of the MPM's)9 and, in addition, 
describes such objects as the command language, the storage 
system, and the input/output system. 


Commands and Active Functions Order No. AG92 


The Commands MPM is’ organized into four sections. Section I 
contains alist of the Multics command repertoire, arranged 
functionally. Section II describes the active functions. 
Section III contains descriptions of standard Multics commands, 
including the calling sequence and usage of each command. 
Section IV. describes the requests used to gain access to the 
system. 


Subroutines _ Order No. AG93_ 
The Subroutines MPM is organized into three sections. Section I 


contains a list of the subroutine repertoire, arranged 
functionally. Section II contains descriptions of the standard 


-~Multics Subroutines, including the declare statement, the | 


calling sequence, and uSage of each. Section III contains the 
descriptions of the I/O modules. 


Subsystem Writers' Guide Order No. AK9e 


The MPM Subsystem Writers' Guide is a reference of interest to 
compiler writers and writers of sophisticated subsystems. It 
documents user-accessible modules that allow the user to bypass 
standard Multics facilities. The interfaces thus documented are 


a level deeper into the system than those required by the 
majority of users. 


Peripheral Input/Output Order No. AX49 


The MPM I/O manual contains descriptions of commands’ and 
subroutines used to perform peripheral I/O. Included in this 
manual are commands and subroutines that manipulate tapes and 
disks as I/0 devices. Special purpose communications [/0, such 
as binary synchronous communication, is also included. 


A-1 FO} 


MULTICS POCKET GUIDES 


Commands and Active Functions Order No. AW17 


This pocket guide presents an abbreviated version of the 
commands and active functions described in detail in the Multics 
Programmers' Manual Commands and Active | Functions 
Order No. AG92 
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MULTICS ADMINISTRATORS' MANUALS (MAM) 


Project Administrator | Order No. AK51 


The Project MAM is a guide to the operation of programs in the 
project- administration area. The infermation in this manual is 
of interest not only to project administrators but also to 
accounting administrators (who may function as project 
administrators) and to system administrators (who may function 
in any administrative capacity). 


Registration and Accounting | 
' Administrator . Order No. AS68 


The Accounting MAM is a guide to the operation of Multics 
billing and accounting programs. It is necessary that both the 
accounting and system administrators know how to perform the 
Multics billing operations. 7 


System Administrator Order No. AK50 


The System MAM is a guide to the overall administration of the 
Multics system. This manual discusses the contents of 
administrative directories and data bases and special user 
identifies (such as the daemons), describes installation 
parameters and system logs, explains the various tasks that are 
the responsibility of the system administrator, and includes the 
commands needed to carry out these responsibilities. Also, the 


functions of the system security administrator are explained in 
the MAM System. 


A-3 KQ)1 


PROGRAM LOGIC MANUALS (PLM) 


NOTE: The Distribution of Program Logic Manuals is Restricted 


ALM Assembler 

Carry Facility 

Hardware & Software Formats 
Reconfiguration 

Storage System 

System Dump Analysis 

System Initialization 
System Metering 

System Tools 


User Ring I/0 System 


Order 


Order 


Order 


Order 


Order 


Order 


Order 


Order 


Order 


Order 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


AN69 


AN76 


AN87 


AN71 


AN61 


AN53 


AN7O 


AN52 


AN51 


AN57 
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OTHER MULTICS MANUALS 


APL Users' Guide 

BASIC 

COBOL Reference Manual 

COBOL Users' Guide 

DF AST Subsystem Users' Guide 
FAST Subsystem Users' Guide 
FORTRAN Reference Manual 
GCOS Environment Simulator 
Graphics Seen. 

Hardware Diagnostic Aids 
Logical Inquiry and Update System (LINUS) 


Multics Integrated Data Store 
Reference Manual 
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Order 


Order 


Order 


Order 


Order 


Order 


Order 


Order 


Order 


Order 


Order 


Draft 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


AK95 


AM82 
AS4Y 
AS43 
AT59 
AU25 
AT58 
ANO5 
ASHO 


AR9Q7 


AZ4Q9 
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OTHER MULTICS MANUALS 


Multics Relational Data Store 
Reference Manual 


New Users' Guide 

Online T&D Reference Manual 
Operator's Handbook 

PL/I piteaaee Specification 
PL/I Reference Manual 
Processor Manual 

SORT/MERGE 

Site Preparation Manual 
System Summary Description 
Virtual pengry: 


WORDPRO Reference Guide 
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Order 


Order 


Order 


Order 


Order 


Order 


Order 


Order 


Order 


Order 


Order 


ORder 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


No. 


AW53 


AL4O 


AUT7 


AM81 


AG94 


AM83 


AL39 


AW 32 


DC79 


AK15 


AG95 


AZ98 
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HELP MANUALS 


e THE MULTICS TECHNICAL MANUALS ARE LISTED BELOW. ALL 
‘MANUALS/UPDATES THAT SPECIFY A DATE IN THE DATE COLUMN CAN BE 
ORDERED FROM THE DISTRIBUTION CENTER; FOR INFORMATION ABOUT HOW 
TO ORDER MANUALS TYPE: 


help order _manuais 


& IF THE "Date" COLUMN DOES. NOT CONTAIN A DATE FOR A MANUAL, THAT 
MANUAL IS “IN PROGRESS;" WHEN A DATE IS SPECIFIED, YOU CAN ORDER 
TE , | 


So PROGRAM LOGIC MANUALS (PLMS) ARE LISTED SEPARATELY, AFTER THE LIST. 
OF CUSTOMER MANUALS. MARKETING DOCUMENTS (E.G., BROCHURES, 
PRODUCT BRIEFS, ETC.) ARE NOT INCLUDED. | 


THIS MANUAL LISTING WAS CURRENT AS OF JULY 23, 1979 


Order Through 
Number Rev. Add. Release Date Title 


CUSTOMER MANUALS 


OS ey te NE eR Sh eS me a 


+AG90 -01 -~- --- 05/73 MPM - Introduction 
AG91 -02 --- Te0 03/79 MPM - Reference Guide 
A 8.0 aaa 
AG92 -02 --- 5.0 01/77 MPM = Commands and Active Functions 
A 6.0 11/77 | 
Bo 7.0 02/79 
aoe 7.0€ ----- 
D 8.0 -=--- 
AG93 ~02 --- 6.0 02/78 MPM - Subroutines 
A 7.0 12/78 
B 8.0 +--+ 
AG9Q4 -02 --- 5.0 07/76 PL/I Language Specification 
A 6.0 10/77 
B 7.0 12/78 
1G 8.0 aa 
+AG95 -00 cetas --- 06/72 Virtual Memory 
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HELP MANUALS 


AK50 -01 --- 5.0 10/76 MAM = System 
A 5.0 03/77 
B 6.0 03/78 
C 120 10/78 
D 8.0 -----= 
AK51 -01 --- 4.0 08/76 MAM - Project 
A 6.0 04/78 
B 7.0 02/79 
C 8.0  --—-= 
AK92 -02 --- Teo 03/79 MPM = Subsystem Writers! Guide 
A 8.0 --=--- 
AK95 -01 --- 7.0 03/79 APL Users' Guide 
-02 ~<- 8.0 ----— 
AL39 -00 --- --- O4/76 Processor Manual 
A --- 09/76 
-01 ots eee. weees 
AL40 -01 --- 6.0 07/77 Introductory Users! Guide 
-02 --- 8.0 ----- Programmer's Introduction to Multics 
AM81 -01 — 620 10/77 Operators' Handbook 
A 6.0 01/78 
B 7.0 02/79 
-02 --- 8.0 === 
AM82 -00 --- 1.0 02/74 BASIC 
AM83 -00 --— 4.0 06/76 PL/I Reference Manual 
A 1.0 09/78 
-01 --- 8.0 Hee 
ANO5 -01 --- 7.0 10/78 GCOS Environment Simulator 
AN50 -01 --- 7.0 03/79 Index to Multics Manuals 
-02 --- 8.0 ----- 
AN52 -01 --- tO 02/79 System Metering 
AN76 -01 --- 7.0 11/78 Carry Facility 
A 7.0 12/78 
AR97 -01 --- 6.0 07/78 Hardware Diagnostic Aids 
A 6.0 11/78 
AS4O -00 <<< 6.0 10/77 Graphics System 
-01 --- 8.0 === 
AS43 -01 ~—— 5.0 12/76 COBOL Users' Guide 
A 6.0 04/78 
B 7<0 02/79 
C 7.0b ----- 
AS44 -01 --- 5.0 12/76 COBOL Reference Manual 
A 6.0 10/77 
B 7.0 01/79 
C 7.0 05/79 
D 7.0b ----- 
AS68 -00 --- 4.0 11/76 MAM - Registration and Accounting 
A 7.0 01/79 
B 8.0 waaHnn 
AT58 -01 --- 5.0 02/77 FORTRAN 
A 6.0 11/77 | 
B TO 06/78 


A-8 FOI 


-00 
-00 


-02 


-00 


-00 


CODDDOOnNA™N COMMON DAANONNDOADONNDOUONVUN FSOWN DOWW O-I] 


o ° 


qooooocoocoqdcoocoocoo0c0ooc0c°c0°eo0o00-$ ao00 - + oOo 


e e ° e 


fo) 
a) 
ie] 


oleate ieke) 


HELP MANUALS 


DFAST Subsystem Users' Guide 
FAST Subsystem Users! Guide 


Online Test and Diagnostics Reference Manual 
MPG - Commands and Active Functions 


SORT/ MERGE 
Relational Data Store (MRDS) Ref. Manual 
MPM - Peripheral Input/Output 


System Programming Tools 


Logical Inquiry and Update System (LINUS) 
WORDPRO Reference Manual 


Bulk Input/Output 


Report Program Generator (MRPG) 
FORTRAN Users! Guide 


MAM - Resource Control Package (RCP) 
MAM - Communications 


MPM - Communications I/0 


Transaction Processing 

Remote Batch Facility (Lev 68/Lev 6)(Prelim) 
gedx User's Guide (Preliminary) 

compose User's Guide 

Debugging User's Guide 

New User's Introduction to Multics - Part I 
New User's Introduction to Multics - Part II 
Error Messages 

emacs User's Guide 
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PROGRAM LOGIC MANUALS 


AN51 -00 --- --- 02/75 System Tools 

AN53 -00 --- -~- 06/75 System Dump Analysis 

AN57 -00 --- --- 05/77 User Ring Input/Output System 
AN61 -00 --- 5.0 07/74 Storage System 

A 6.0 09/78 

AN63 -00 --- --- 02/75 ALM Assembler ; 

AN69 -00 --- ---= 02/75 Message Segment Facility 
AN70O -00 --- “<= 02/75 System Initialization 

AN71 -01 --- --- O4/77 Reconfiguration 

AN80 -00 — --- 0 ewe ne Library Maintenance 

AN85 -01 --- 7.0a€ ------ Communications System 

AN87 -00 “== --- 07/76 Hardware & Software Formats 
NOTES 


A line has been deleted since the last time this segment was updat 
This line has been modified since the last time the segment was up 
+ Some of the information in this manual is obsolete 

MPM Multics Programmers' Manual 

MAM Multics Administrators’ Manuals 

MPG Multics Pocket Guide 
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MULTICS TECHNICAL BRIEFS 


Level 68/Distributed Processing System .. soxt. a -e al (Bed 
Distributed Processing System: Multics Overview ee. és Se ger UBL 
Multics Virtual Memory and Storage System ....... . B13 
Administration and Operating Features .......... B17 
Interactive Programming Environment ........... Beal 
Controlled Sharing and pian tit ae Ete Ce ae a> He ek ke we, IBD 


Multics PL/I e e s e e e . . e e e ° e e ° 2 e e B-27 
Multics APL... BS ae a a tk ee let og Sa ea? ee ee hes SBD 
Multics Data Base Manager a ae a Be usar “iw, igs Rak Ge ae ake - 


B-31 
LINUS : és dk a ES “eS a OR BST 
Word Processing System "WORDPRO- BA tae Hee ee Oa ae Be nee ee - SBS SO 
Multics Graphics System... ge te Ae. eee A : ~ © « B43 
Multics Electronic Mail Facility ee Mon ite B-45 
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Honeywell 


SERIES 60 (LEVEL 68/DPS) 


Honeywell’s Level 68/Distributed Processing Sys- 
tem (DPS), with the Multics operating system, 
offers the user many powerful features, including 
virtual memory addressing, controlled access to 
data, modular design, and advanced segmentation 
concepts that simplify processing. The Level 68/ 
DPS possesses capabilities that enable large-scale 
computer users to solve complex processing 
problems quickly and easily. 


The Level 68/Distributed Processing System con- 
sists of a base system to which performance mod- 
ules can be added in incremental steps, thus offer- 
ing a choice of various levels of performance. This 
easy expansion allows a user to configure the 
exact system needed and helps protect equipment 
investment. 


VIRTUAL MEMORY 


Level 68/DPS virtual memory efficiently and auto- 
matically moves information between main memory 
and secondary storage — independent of hardware 


configuration and without programmer intervention. 


Thus, programs are not constrained by main mem- 
ory limitations and no overlays are required. Fur- 
thermore, user I/O can be handled logically, without 
concern for physical addresses. Integration of the 
68/DPS storage (file) system with virtual memory 
addressing forms a powerful data handling capabil- 
ity, allowing programmers to directly access more 
than 300 billion bytes of stores information. 


SECURITY 


Level 68/DPS hardware and software systems are 
structured for maximum data security. With simple 
commands, access to files can be granted to spe- 
cific persons or groups. Different access rights 
(e.g., read only, execute, write, or combinations of 
these) can also be granted to different users of the 
same file. 


Within the central processor, a hardware mechanism 
maintains the integrity of several levels, or rings, of 
access controls. These rings of protection limit 
access to sensitive data and permit the creation of 
closed subsystems that are mutually exclusive and 
mutually protected. 


© 1978, Honeywell Information Systems Inc. 
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Level 68/ Distributed 
Processing System 


Honeywell 68|DPS 


Since hardware enforces the basic 68/DPS 

security mechanisms, very little system overhead 

is introduced by access control enforcement. After 
the initial access to a file and on every memory | 
access, hardware compares the attempted access 
against the user’s permission. Thus, no additional 
machine instructions are executed for security. 


MODULARITY 


The modular design of the Level 68/Distributed 
Processing System has significant advantages for 
processing flexibility and for system growth. The | 
optimum combination of processor, memory, and 
input/output multiplexer modules can be selected 
for each installation. integrated Network Proc- 
essors, mass storage subsystems, and peripherals 
are additional modules thaf can be added to tailor 
a configuration. A Level 68/DPS system supports 
up to 16 million bytes of memory (four million 
words) and employs two or more processors for 
maximum availability. Memory can be added in 
increments of one million bytes up to four million 
bytes. Beyond this level, memory may be added in 
increments of two million bytes. 
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This approach allows a site to purchase equipment 
for today’s processing needs and add modules to 
meet a growing data processing workload. Further- 
more, each configuration can be given the proper 
mix of processing, storage, and I/O capacity, and 
modified as necessary to meet changing workload 
characteristics. Regardless of the configuration 
selected, the full functionality of Multics is avail- 
able. Any program that can run on the largest sys- 
tem can also run on the smallest, and vice versa. 


Another significant advantage of Level 68/DPS 
modular architecture is the capability for con- 
figuring fully fail-safe systems. This is accom- 
plished by including additional system control 
units. I/O multiplexers, network processors, and 
appropriate peripheral subsystems. Note that it is 
not necessary to add processor modules since 
Level 68/DPS always contains at least two. 


PROCESSOR MODULE 


The Level 68/DPS processor module executes pro- 
grams and handles all computations. For example, 
it performs instruction fetching, relative and abso- 
lute address preparation, memory protection, data 
fetching, and data storage. These functions are 
overlapped for quick instruction execution. 

Other features of the processor include: 

e Hardware for handling segmentation and paging 
in virtual memory . 

e Hardware for interrupting a process in execution 
at any point (including in mid-execution of an in- 
struction), saving processor status, and restoring the 
process later without loss of continuity 

@ High-speed cache memory for improved perform- 
ance . 

e Hardware for enforcing several modes of memory 
access 

e Hardware for implementing data integrity and 
security mechanisms 

e@ Assoctative memory for fast hardware access to 
Virtual memory 

@ Program-addressable registers for preparing virtual 
memory addresses 


Processor Organization 


The Multics processor module is organized around 
functional units: 


© Control Unit — provides the interface between 
the Operations Unit and the system controllers 

@ Operations Unit - Contains the logic to execute 
binary arithmetic and logical functions 

e Decimal Unit — includes an Extended Instruction 
Set (EIS) within the processor’s basic repertoire of 
instructions, including instructions for processing 
character string, decimal data, and bit strings 

e Appending Unit — implements segmentation and 
paging of the virtual memory; provides 24-bit ad- 
dressing; contains 15 segment descriptor words and 
16 page table words on a most recently used basis; 
and provides a descriptor segment base register, 
eight segment pointer registers, and ring protection 
hardware 

@ Cache Memory Unit — holds the most recently 
used information from main memory and improves 
system performance by reducing instruction and 
data fetch time 


Processor Modes of Operation 


The processor operates in three modes: absolute, 
privileged, and nonprivileged. All instructions are 
available in the absolute mode. Privileged instruc- 
tions, such as those that operate on the descriptor 
base register and input/output devices, are avail- 
able only in absolute and privileged modes. Most, 
but not all, of the instructions are available in non- 
privileged mode. General users are restricted to the 
nonprivileged mode and thus are prevented from 
executing any instructions that could interfere with 
other programs or with the Multics system software. 


The full segmentation and paging capability of the 
processor is used in the privileged and nonprivileged 
modes for fetching instructions and operands. Ad- 
dressing in the absolute mode does not use the seg- 
mentation and paging capability and is not generally 
available to user programs. 


Segmentation 


Segmentation divides the user’s address space into 
many parts and assigns attributes (access control 
and length, for example) to these parts based on 
their logical use. Like a conventional file, a Multics 
segment is a collection of instructions or data spec- 
ified by the user. It has a symbolic name and access 
control list and can vary in length. A segment can 
be addressed directly, as memory can, and does not 
have to be read or written record-by-record as a 
conventional file wouid. 


The segment is the basic unit of information shar- 
ing. Different users can incorporate a single segment 
into their programs merely by specifying the seg- 
ment name. A program doesn’t need to copy a see- 
ment to use it, saving time and climinating dupl- 
cation in main memory. To control this sharing, 
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each segment has an access control list containing 
the name and access privileges of each person who 
can use the segment. The hardware checks these 
access privileges on each reference to a segment by 
any user. 


Certain segments, containing only instructions 

or constants, are especially easy to use and 
efficient in occupying storage space. These “‘pure- 
procedure” segments store their data and control 
variables separately. Pure procedure segments do 
not modify themselves; they are also totally re- 
entrant. More than one user can use the same re- 
entrant procedure simultaneously without having 
to copy it. This enhances sharing and saves storage 
space. The Multics operating system, compilers, 
and application programs all utilize pure procedure. 
The major benefits of segmentation are: 


e Stored data and procedures can be referenced 
easily and directly 

® Logical units such as programs and data are pro- 
tected by hardware 

e Users can directly share procedures and data 
bases 


Paging 
Segments can be of different sizes, and their sizes 
can change during the operation of a program. in 


order to simplify allocation of main memory, each ; 


segment is divided automatically into fixed-size 
storage units called pages. This division — and the 
subsequent manipulation of the pages — is totally 
transparent to the user and requires no action on 
the user’s part. In addition, any access controls 
established for a segment apply to the pages that 
make up that segment. 


The pages of a given segment need not be located 

in contiguous storage blocks. They do not even have 
to be in main memory all at once. As a page is 
needed in main memory, it 1s retrieved automat- 
ically from secondary storage and placed in any 
available block in main memory. When main mem- 
ory is filled and more pages are needed, some pages 
have to be displaced. Pages not used recently will 
_be moved (swapped) to secondary storage. (For 
added system efficiency, pages that are part of a 
pure-procedure segment or have never been written 
into do not have to be swapped out, since a copy 
stil] exists in secondary storage. These blocks of 
memory can simply be cleared and overwritten 

with other pages.) 


Paging has distinct advantages: 


e A user can write and operate a program without 
planning for its storage allocation needs or for the 
management of the segments. 

@ Paging provides a simplified technique for dy- 
namic storage management and reduces operating 
system overhead by allowing optimum loading of 
main memory and avoiding compaction problems. 


e Paging uses the system’s high-speed storage ef- 
fectively by fetching only pages that are actually 
referenced, rather than an entire program or file. 


Ring Structure 


The Level 68/DPS ring structure extends the con- 
cept of a two-state machine (i.e., master-mode and 
slave-mode) to a multi-state machine. Level 68/DPS 
provides eight states of execution with adequate 
tools to allow proper administration of access privi- 
leges to the system users within them. This imple- 
mentation allows segments to be grouped into rings. 
The number of each ring (0-7) designates the level 
of privilege assigned to procedure segments executed 
in that ring. Ring 0 has the highest level of privilege. 
Privileged ring segments, such as the supervisor and 
special user subsystems, are protected from uncon- 
trolled use by less privileged rings. These segments 
can only be used by procedures in less privileged 
rings if called via a special “gate” mechanism. The 
access permission checking is still required as well. 


The ring structure, with its obvious applications to 
information protection and security, is an integral 
part of the paging and segmentation hardware. The 
ring structure offers users numerous benefits, for 
example: 


e Users can create protected programs and data 
bases for controlled use by others 

e A supervisor program can be implemented in 
layers with differing degrees of privilege 

e A programmer can debug a program in an unpriv- 
ileged environment and then move it to a privileged 
environment with no recompilation or modification 


SYSTEM CONTROL UNIT 


The system control unit (SCV) is the principal inter- 
face between all central system components. It pro- 
vides complete system interrupt contro! which 
regulates communication between components and 
services all demands on memory under priority con- 
trol. The system control unit handles the switching 
of all control signals, addresses, and data into and 
out of the memory units. Memory units are modular 
and each connects directly to a system control unit. 


Up to eight system control units may be configured 
in a Level 68/DPS system, with each SCU capable 
of controlling one megaword (four megabytes) of 
memory. However, note that maximum memory 
size currently available is four megabytes. 


Additionally, the SCU checks integrity on all data 
and control paths to and from memory units as 
well as the paths to and from the other system 
components. It also provides memory configuration 
switching. 

The system clock within the SCU a 52-bit binary 
counter that increments at one-micromcond inter- 
vals - is used as a calendar clock. The 142-year 
capacity of the clock makes it possible for Multics 
software to operate on a consistent time base. 


MEMORY 

The metal-oxide semiconductor (MOS) memory of 
the Level 68/DPS Systems can range from 512K 
words to four million words. Two words, plus Error 


Detection and Cotrection (FDAC) bite, are accessed 
in each merry eyele 


INPUT/QUTPUT MULTIPLEXER 

The input/output multiplexer (LOM) interfaces the 
system control units with the peripheral units and 
integrated network processors. The 1OM can operate 
many different types of devices. It is controlled by 
information stored in memory. 


‘The IOM can transfer data between I/O devices and 
memory while processors continue to run programs. 
I/O transactions are controlled by lists of control 
words prepared by the Multics operating system and 
stored in memory. When an I/O transaction is com- 
plete, or when special conditions are detected, the 
IOM causes a program interrupt. 


The IOM has attractive performance characteristics: 


e Peak IOM transfer rate of more than four million 
bytes per second 

® Up to 56 simultaneously active data channels per 
1OM 

@ Peak channel transfer rates of more than one 
million bytes per second 

® Scratchpad storage for control words 

@ Eight special channels for specific system functions 


The IOM oifers complete memory protection for 
all 1/O data transfers. Each data channel functions 
independently, with its own memory assignment. 
Parity is generated and checked on all information 
sent to and from the system controllers and the 
peripheral subsystems. 


PERIPHERAL SUBSYSTEMS 


The Level 68/DPS mass stcrage subsystem uses the 
freestanding MSP0603 mass storage processor to 
contro! up to 32 mass storage units. Multiple mass 
storage subsystems can extend the virtual memory 
size to a maximum of 512 mass storage units. Three 
different devices are supported; the MSU0402 

(78 megabytes), MSU045I (157 megabytes), and 
the MSU0500 (626 megabytes). These devices can . 
be intermixed on the same mass storage processor. 


The MTPO601 Magnetic Tape Processor supports 
the MTU0400, MTU0500, and MTU0600 tape 
units. These devices range up to 200 inches per 
second and i600 bits per inch. Other peripherals 
include the PRU1100/1200/1600 ASCII line 
printers (1100, 1200, and 1600 lines per minute, . 
respectively), 1050-card-per-minute readers, and 
100- to 400-card-per-minute punches, all under the 
control of the Unit Record Processor (URP). Up to 
eight individual devices can be controlled by a 
single URP. 


NETWORK PROCESSOR 


The Integrated Network Processor (INP) controls 

all remote terminal interaction with Level 68/DPS 
host system. Connected to the central system via 

an 1OM, the Integrated Network Processor provides 
the varteta Interfaces requited hy the elernents aint 
privadeneesba cel fad eedeed ayateiny aa well wean Tee tlity 
fai dialog with the luet ayaten. By perlurming the 
tasks of message Management and message handling, 
the INP frees the host for other processing functions. 
The resources of the central system are called upon 
only when the message is submitted for information 
processing. However, some networking functions 
(e.g., a message switch) can be accommodated by 
the INP without any involvement of the host 
processor. 


TERMINALS SUPPORTED 


Level 68/DPS systems can communicate with var- 
ious types of terminals, including the following: 


- Interactive Devices 


Honeywell VIP 7105, 7205, 7705, and 7800 
Teletype Models 33, 35, 37, 38, and 40 


1BM3270 

IBM2741 and 1050 (EBCDIC and Correspondence) 

IBM 1050 

iBM 2780 

Trenduta Models 1000 and 4000 

Datel 30 

Dura 1021 

GE TermiNet 300 and 1200 (up to 1200 bps both 
half or full duplex) 

Execuport 310C and 320C 

Texas Instruments Silent 700 Series 

Adage Inc. Advanced Remote Display Station 

IMLAC PDS-1D Graphic Display Computer 


- Tektronix (graphics devices to 9600 bps) 


DIGI-Log Telecomputer Model 109 

Data Products Portacom 

Computer Devices Incorporated Teleterm 1030 

(including ASCII/APL models) 1132, 1203 

Teleray Model 3711 

DEC GT40 Display Processor, DEC writer II, 
DECwriter LA36 (300 baud ASCII) 

DEC Graphics Models | 2 and 15 

Hazeltine 2000 (ASCII) 

Delta Data Systems (Alphanimeric CRT up to 
2400 bps) 

Xerox 2700 (Diablo printer with plotting capability) 

Anderson-Jacobson Models AJ630 (ASC Il), AJ832, 

and AJ841 

Gen Com Systems GSI300 (300 baud ASCID and 

GSC 300Q 

Lear-Sicgler ADM-2 Display Terminal! 


‘ ADDS Consul Model 980 


DTC300 Series 

Infoton Vistar/II 
Bedford 575 (Selecterm) 
BeeHive Super Bee 


Remote Job Entry Devices 


Absentee (batch) processing is supported at the 
central site and at remote sites. Remote batch ter- 
minals such as the Honeywell Model G115, Data. 
100/78 (using Honeywell Model G115), RNP702, 
IBM 2780, Honeywell Level 6, and Mohawk 2400, 
offer remote bulk 1/O capability and remote job 
entry. 


RECONFIGURATION 


The memory modules, central processors, mass 
storage devices, and terminals in a 68/DPS system 
can be reconfigured dynamically, without inter- 
rupting user service. This allows failing devices to 
be removed from processing for maintenance and 
reconfigured automatically following repair. In 
addition, failing memory pages are automatically 
deallocated whenever a double-bit (uncorrectable) 
error is discovered. Large configurations can also 
be split into smaller separate systems for block 
time processing or testing without service shutdown. 


SYSTEM CONFIGURATIONS 


_ System configurations can be tailored to user 
requirements. An entry-level configuration consists 
of: 

A Level 68/DPS System Control Unit with 512K 
words of memory 

An Input/Output Multiplexer 


An Integrated Network Processor 

An MTP0601 Magnetic Tape Processor with a mini- 
mum of two MTU0S500 tape units 

An MSP0603 Mass Storage Processor with two 
MSU0402 Mass Storage Units providing 156 mil- 
lion bytes of storage 

A printer 

An operator console 

A full selection of terminals 


The system can be significantly expanded to a muaxi- 
mum compiement of equipment: 


Level 68/DPS with power options to 4.3 times proc- 
essing power of entry systems 

8 System Control Units with a total of four million 
words of memory 

2 Input/Output Multiplexers 

4 Integrated Network Processors 

32 MSP0603 Mass Storage Processors and 512 
MSU0500 Mass Storage Units providing 300 bil- 
lion bytes of storage 

MTPO60! Magnetic Tape Processor and 16 
MTU0O6O0 Magnetic Tape Units (per subsystem) 

8 unit macro devices (per subsystem) 
An operator console 

A full selection of terminals 


Specifications may change as design improvements are introduced. 


MAXIMUM CONFIGURATION 


DUAL PROCESSING 
UNIT 


DUAL PROCESSING ADDITIONAL 
UNI 


_ PROCESSING UNIT 


8 SCUs, 16 MILLION BYTES MEMORY 


PERIPHERAL SUBSYSTEM: 


4 NETWORK PROCESSORS (96 LINES FACH) 
16 MTU0600 TAPE UNITS PER SUBSYSTEM 
8 UNIT RECORD PERIPHERALS PER SUBSYSTEM 


Honeywell 


Honeywell Information Systems 
Inthe U.S.A.: 200 Smith Street, MS 486, Waltham, Massachusetts 02154 
In Canada: 2025 Sheppard Avenue East, Willowdale, Ontario M2JU 1W5 
In Mexico: Avenida Nuevo Leon 250, Mexico 11, D.F. 
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SERIES 60 (LEVEL 68/DPS) 


Multics, one of the most powerful and comprehen- 
sive large-scale systems in the world today, provides 
general purpose data processing service for users 
dealing with challenging business and scientific 
problems. Based on the concept that the computer 
is only as productive as it ts accessible, Multics offers 
abroad range of features and capabilities within 
a servicc-oricnted environment © and addtesses the 
reliability, availability, and system growth require- 
ments Of distributed processing users. 


PROCESSING CAPABILITIES 

Multics is for large and small users ... experts and 
novices. Its total online, interactive orientation Is 
ideally suited to a variety of processing activies in- 
cluding: 

BATCH - Multics supports both local and remote 
batch processing. Interactive users can submit 

batch jobs for execution: batch jobs can also int 
liate other batch jobs. Jobs written for batch exe- 
cutton can also be run mtcractively without change. 


REMOTE JOB ENTRY — Multics supports num- 
erous devices tor remote job entry. These include: 
Mohawk Data Sciences 2400, DATA 100 Model 78, 
IBM 2780, Honeywell Model G-E1S, Floneywell 
RNP702, and several Honeywell Level 6 models, 


TIME SHARING — Full time sharing capabilities 
are available on native mode, interactive Multies. 
In addition, two other environments, the Multics 
FAST and DFAST subsystems, provide the user 
with varying levels of time sharing power and proc- 
essing performance. 

TRANSACTION PROCESSING | Multics trans- 
action processing offers flexibility and scope un- 
matched in other systems. Perminal ortented, the 
system doesmt require special executive programs 
to monitor terminal tapol and then to process user 
requests in batch. Applieatious can be written in 
any fanguage and directly decessed from any number 
of terminals or batch jobs ... simultaneously ... in 
acompletely shared environment. System facilities 
allow intertices fo specialized data bases as well as 
CONCUUPOHE decess control, pourri zadion, recovery, 
md online forms geaeratiou. 


©) 1977, Tloneywell Laformation Systeuis tae. 
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Distributed Processing 
System: Multics Overview 


WORD PROCESSING = Multices’ advanced word 
processing facilities include: 
e Powerful text editors 
Document formatting capabilities 
Error detection tools 
e SPEEDTYPE (shorthand for typists) 
e Online dictionari¢s 
e Artwork macros 
e Electronic mail 
Together, these features enable the Multies user to 
create and maintain error-free documents and pro- 
duce formatted oulput. 


GRAPHIC PROCESSING - A general purpose inter- 
face enables user and application programs to create, 
edit, store. display, and animate graphic material. 
Multics’ graphic features include: 
e Terminal independence 
© Powerful editing capabilities 
Permanent storage capabilities 
e Sharing subobjects and structures 
Dynamic animation 
Local editing 
Incremental picture updating 


REAL TIME PROCESSING — Multies can provide 
real-time respouse to specified users or jobs (dead- 
line job scheduling, for example). Thus, the system 
is useful in operations control functions such as 
process control monitoring. 


USER ORIENTATION 


Uniform User Interface 


Key among Multics’ unparalleled accessibility 
features is tts uniform user interface. All the systenr’s 
processing functions — from batch to time sharing to 
graphics arc available via a single, consistent 
interface. There are no format or execution dilfer- 
ences between usage types. A program written ian 
infcractive cavironment will run in bateh without 
conversion oF modification, and view versa. Any 
ferminabathached to the system can, unless speci 
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cally restricted by the system’s administrators, 
access any program or feature. 


Also implicit in the Multics environment is the con- 
cept of total compatibility. There ure no restrictions 
on languages used to access data bases or files. Pro- 
grammers can develop COBOL applications, for 
example, with certain modules written in other lan- 
guages, and be assured of total compatibility and 
equal processing efficiency. Moreover, data and pro- 
grams associated with one processing dimension 
(c.g., transaction processing) are totally accessible 
trom any other dimension. 


Totai Oniine Orientation 


Multics’ architecture is oriented directly toward on- 
line applications. Whereas other systems provide 
Online capabilities through executive packages, 
Multics is completely interactive, and does not use 
such packages. As a result, in high-volume trans- 
action-oriented environments where there is sig- 
nificant terminal activity, Multics provides unique 
advantages Over other architectures. 


Total Sharing 


Multics nermits the controlled sharing of operating 
system software and libraries, language processors, 
data bases, and user code and data. Even with mul- 
tiple users simultaneously compiling COBOL jobs, 
for example, only one copy of the COBOL compiler 
is in use. And since all Multics language processors 
generate reentrant code, even users’ programs can 
be shared without special programming. 


EASE OF USE 


From its inception, Multics has incorporated features 
and capabilities that make it one of the most acces- 
sible and easy-to-use systems on the market today. 


Interactive Orientation of All Facilities 

Every aspect of Multics is online-oriented, including 
the language processors, applications, data base man- 
agement facilities, utilities, administrative tools, and 
metering and tuning capabilities. 


No Job Control Language 


Unlike other systems ~ which require that the user 
learn a job control language (JCL) prior to running 
ajob - Multics provides control functions via a 
standard command processor approach, thus elim- 
inating complex JCL. System commands and rou- 
tines supply the logical branching, conditional exe- 
cution, file system, and I/O control required to 
direct a job through simple and complex execution 
paths. Thus, the Multics user need not Jearn a new 


batch interface, or become a JCL expert to use the 
system for problem solving. 

Flexible Environment Shaping 

Multics matches the computer’s processing environ- 
ment with the user’s particular needs. Providing a 
flexible interface, Multics enables users to continue 
using the computer in the way they are accustomed 
even though they are changing to a new system, 
The concept of shaping environments is particu- 
larly beneficial for data processing organizations 
that service many diverse user groups simultane- 
ously. Each group can develop — using standard 
administrative tools — specialized interfaces to 
satisfy unique operating requirements. Typical of 
these tools is the special command processor with 
which users can define their own abbreviations for 
frequently-used command lines or sequences of 
commands, as required. 


EXEC-COM Facility 


With this feature, users can write programs to exe- 
cute stacked command lines. The additional contro] 
capabilities provided by the EXEC-COM facility 
allow for logical branching, the maintenance of 
variables, command-level I/O, and conditional exe- 
cution. Thus, it is possible to develop routines 

for functions which typically require higher level 
languages without having to actually use such 
languages. 


Help Files 


Multics help files contain printed text which pro- 
vides immediate, online assistance to users request- 
ing data on various system topics, including the use 
of Multics commands and subroutines. Tutorials on 
each system feature are thus readily available. Sim- 
ilarly, users can document their own programs and 
routines, and avoid continuous referral to cumber- 
some hard-copy documentation. 

Memo Facility 

The memo facility allows users to indicate when 
specified events ure to occur on the system. Events 
to be scheduled can be inter-job signals, messages, 
or program executions. Typical examples include 
simple date reminders and the automatic scheduling 
of an installation’s batch applications. 


Intelligent Defaults 


Multics -— via its intelligent defaults lets users per- 
form certain functions on the system without having 
to consider concepts that do not pertain to their 
particular application. In a typical situation where 
the user wishes to archive data on tape, numerous 
details such as tape density and blocking factors 
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must also be defined. For users to whom these de- 
tails are not relevant, Multics standard defaults per- 
mit the archive tape to be written via simplified 
1/0 routines from command level. 


VIRTUAL MEMORY 


‘Phe Muttics virtual memory implementation, totally 
invisible fo User programs, means that programmers 
can concentrate on problem solving rather than be 
concerned with real memory constraints and mem- 
ory management (¢.g., paruilions and overlays). 


Virtual memory ts limited only by the amount of 
avallable mass storage. So, programs written for the 
largest configuration can run on the smallest without 
modification. No standard, fixed main memory-to- 
mass storage ratio is required to ensure efficient 
system operation. Regardless of the ratio, Multics 
can be tuned to perform within its real memory 
constraints, 


Segmentation 

Multics organizes information mo segments 

logical, named units containing dala, programs, or 
directories of other segments. The segments and 
their directories form a uniform file system for all 
users, the administrative and accounting system, and 
the system software itself. Segments can increase 
dynamically up to | megabyte in length, and files 
can span hearly 1000 segments. 


‘Paging 


Multics designers devised the paging concept to 
avoid the system performance limitations that re- 
sult from swapping large files (segments in the case 
of Multics) in and out of main memory. In Multics, 
segments are subdivided into “pages” (4096-byte 
blocks). Address mapping at the hardware level 
enables the system to determine if the page of a 
requested segment is in memory — and if not, to 
locate Chat page, (ransport it to memory, and 
schedule it for execution by the waiting process. 
Demand paging eliminates space aHocation and 
compaction problems and maximizes system per- 
formance. Paging is completely transparent to the 
user. And only those pages required for the execu- 
tion of a program are brought into memory at any 
given time. 

The acttal movement of information in and out of 
main memory is completely automatic and trans- 
parent. Dati required by the user. for computation 
or mantpulation, ts retrieved from peripheral storage 
and toserted taomain memory without the user ever 
Knowine the transier took plaice. 


PROGRAM DEVELOPMENT 

Multics ranks as one of the industry’s premiere solt- 
ware development tools. It has powerful source code 
manipulation techniques for entering, editing, and 
archiving code, and for automatically structuring 
programs for easy reading and use. Its online debug- 
ging tools facilitate checking out new code, and id 
in the fine tuning of programs, Multics also provides 
options for dynanie linking or prelinking of pro- 
grams, and standard calling sequences for system 
libraries and user programs. 

Multics’ fully compatible language processors sig- 
nificantly contribute to the system’s outstanding 
program development capability. These processors 
including PL/I, COBOL-74, FORTRAN, APL, ALM 
(assembler), and BASIC — can be fully shared. Be- 
cause of their compatibility, programs written tn 
APL, for example, can call those written in PL/I 

or FORTRAN. Compatibility is restricted only 

by the data types supported by each language. And 
since all Multics compilers generate reentrant code 
by default, all user programs are shared; no special 
coding procedures are required. 


APPLICATIONS DEVELOPMENT 


During applications development, the programmer 
typically must address concerns such as terminal 
control, data base management, interfaces to system 
functions, data security and integrity, and 1/O tnter- 
faces. Multics provides a standard applications envi- 
ronment that can be shaped to individual needs. 
Thus, programmers can avoid these problems and 
concentrate on programming, thereby significantly 


shortening the development cycle. 


DATA BASE MANAGEMENT 


The Multics Data Base Manager (MDBM) offers two 
data base management interfaces: Multics Integrated 
Data Store (MIDS), a subset of I-D-S/Tf:and Multics 
Relational Data Store (MRDS). MIDS supports 
schema/subschema data base definitions to provide 
data and program independence. Data base struc- 
tures which can be developed include sequential, 
network, hiecrarchteal, or cyclical. MRDS provides 
data and program independence via model/submode! 
data base definitions and nonprocedural user retrieval 
and update mechanisms. Both interfaces allow inter- 
active or batch usage, sharing. concurrent access, and 
access Via programs written in any language available 
on Multics. 


ADMINISTRATIVE CONTROL 
A significant strength of Multics ts its ability to pro- 
vide service to a wide variety of users simulGincously 
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without the workload of any one group adversely 
affecting that of another. Multics’ comprehensive 
set of administrative controls make this high level 


of processing service possible. These controls include: 


e Decentralized control options 

e Guaranteed resource allocations 

e Priority scheduling with specified response char- 
acteristics 

e Deadline job scheduling 

e Flexible service pricing 

e Automatic or on-demand billing 

e Automatic user or project cut-off when resources 
are expended 

e Online metering and tuning 

e Standard environment shaping 


EASE OF OPERATION 


The operational features in Multics make its utility- 
~ grade service readily available to a wide variety of 
users. For example, there is mo system or library 
generation or edit. The operator can start the system 
simply by typing one command at the console. 
System software and libraries —- delivered patch- 

free 


- can all be updated online. A new compiler or 


application can be added without shutting the sys- 
tem down, and with only one command, new soft- 
ware can be installed without affecting users working 
with other existing packages. 


Multics can run unattended. An automatic reboot 
feature automatically restarts the system in the 
event of a failure. The system’s online test and diag- 
nostic capabilities permit the user to check out a 
malfunctioning component online, remove it frora 
service if necessary, and dynamically reconfigure 
the remaining system components ... all without 
interrupting user service. 

Pile integrity is fundamental in a service-oriented 
environment. Multics offers automatic mechanisms 
which optionally journalize recent file updates 
within the system’s virtual memory. Should a fail- 
ure cause temporary loss of data, these journals can 
be reloaded to continue service. Duplicate file copies 
are not necessary since Multics itself provides file 
backup. 


Additional ease-of-operation features include: 


e Online administration and billing 
e Operation from any terminal 
e Dynamic control of the priority scheduler 


COMPATIBILITY WITH LEVEL 66 

Level 66 and Level 68/DPS systems share a high 
degree of compatibility, In their respective hard- 
ware configurations, only the central processors 


differ. The Multics central processor is a superset of 
the Level 66 unit and has a switch which allows it 
to run Level 66 GCOS, thus providing users of both 
systems added flexibility and backup. 


A special Multics subsystem called the GCOS En- 
vironment, allows GCOS job decks or IMCVs to be 
run without change. GCOS files can also be trans- 


ferred between the two systems using standard 
GCOS tapes. 


Multics, through the GCOS Environment, also sup- 
ports several languages that run under GCOS, includ- 
ing JOVIAL, ALGOL, COBOL-68, GMAP, and 
FORTRAN-Y. 


DISTRIBUTED SYSTEMS ORIENTATION 


Multics is ideally suited to the development of net- 
works of distributed mainframe systems. With exist- 
ing hardware and software, Multics can be intercon- 
nected with a variety of other systems to form 
networks, that address a broad range of user re- 
quirements. 


With this approach, users establish networks in which 
files, programs, and data can be shared among the 
various systems easily and with maximum security. 
For example, a programmer could log onto an 

IBM 370/158, and then have required data trans- 
mitted from a CDC-7600 to a Multics system for 
processing, with the output going to the 370. Num- 
erous variations of this approach are possible. In 
fact, Multics can currently interface with systems 
such as IBM 360/370s, Burroughs 4700 and 6700s, 
CDC Cybers, and Univac 1100/90s. 


SECURITY 


Multics offers high levels of security unattamable 
on other systems today. Several elements cooperate 
to make this outstanding system, data, and program 
protection possible. These clements are passwords, 
access control lists, multistate ring protection mech- 
anisms, and access isolation methods. No special 
coding is required to make use of any of these ele- 
ments; only standard system commands need be 
executed. 


Passwords 


The Multics password mechanisms control access to 
the system and verify users’ identities. Each user 
has a system-maintained password which can be 
changed at any log-on. Passwords are stored in en- 
crypted form so that a user’s password will not be 
revealed accidentally. When the user attempts to 
log on the system, the typed in password ts en- 
erypted and verified by comparison against the one 
stored in the system. Precautions are tuken fo en- 


sure that passwords are not exposed during the log- 
on sequence. 


Access Control Mechanisms 


An Access Control List (ACL) is used to control 
access to every segment in the storage system. 
Through the ACL users can grant specific access 
rights (c.g., read, write, execute) to individuals or 
groups of users. System hardware enforces access 
control during the execution of each individual 
machine instruction. 


Ring Protection 

A special hardware implementation, the Multics 
ring structure is a multilevel approach to data and 
program access control. The ring structure contains 
eight levels of execution (rings 0 through 7; 0 being 
most privileged, and 7 the least). Within this struc- 
ture, users can access information only in those 
segments at the same level or higher (less privi- 
leged) than the current state in which they are 
executing. The Multics operating system resides in 
the most privileged ring (0) while users generally 
execute in the less privileged rings. 


Access Isolation Mechanism 


The Access Isolation Mechanism (AIM) incorporates 
administrative controls to grant or deny access to 
information in the data base. AIM is a way of organ- 
izing users into groups among which communication 
can be restricted or denied. Like all other types of 
Multics access control, AIM is initially verified by 


Multics software and is hardware-enforced at every 
reference thereafter. However, AIM also can prevent 
users from granting — to other users access to 
even their own information. AIM can be invoked or 
disabled at the discretion of each Multics site. In 
addition to administrative controls, AIM provides 
extensive security auditing controls to monitor user 
activity. 


GROWTH 


Like other Honeywell systems, Multics” hardware 
architecture provides the benefits of modularity 
and an easy, paced growth that does not require 
swapouts to upgrade to higher performance levels. 
This easy expansion allows a user to configure the 
exact system needed and protects equipment 
investment. It is not necessary to change the oper- 
ating system, system libraries, or user codes in 
order to move to a more powerful Multics system. 


SAMPLE SYSTEM REQUIREMENTS 

A typical entry-level Multics configuration consists 
of the following components: 

e Central System, with 512K words of memory 
(2 million bytes) 

e One System Control Unit 

e One Input/Output Multiplexer 

e One Integrated Network Processor 


e Two MSU0402 Mass Storage Units 
e A minimum of two MTU0500 Magnetic Tape 
Units 


Honeywell 
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LEVEL 68 


The Multics Storage System is a modular, hierar- 
chical file system augmented by a comprehensive 
virtual memory. An integral component of the 
Multics Operating System, the storage system is 
just another reason why Honcywell believes Multics 
to be the most advanced computer system available. 


HIERARCHICAL STORAGE SYSTEM 


In the Multics System, all information is grouped 
into segments, collections of instructions and/or 

data associated with a particular name. Albof the 
sepments are stored tna tree structured hierarchy 
(see Hlustraftion), (he beginning of which is called 
the root. The branches emanating from the root 

lead to either nondirectory or directory segments. 


The Directory Concept 


The sole function of a directory segment ts to 
catalog the segments residing below tt inthe tree. 
Fach directory contains the names of the subor- 
dinafe segments and lists their attributes including 
length, virtual memory address, date and time the 
segment was created, list of users allowed to access 
the segment and with what access mode (read, 
write, execute, or null). 


The directory concept is the key to several Multics 
features, including storage structure, administrative 
control, access control, search rules, and naming 
conventions. For example, all users registered on 
the system are grouped into projects. Fach project 
has a directory, and each user in that project has 
his own directory subordinate to the project direc- 
tory. A user may create additional subordinate 
directories under his own directory or under direc- 
tories to which he has been granted specific access. 
He may also create “links” in his directory to seg- 
ments to which he has specific access. “Phis capa- 
bility is often used to share data and/or programs. 


The Segmentation Concept 

All information within the storage system is stored 
in the form of segments. Provided the user has the 
proper access rights, all information is directly 
addressable. In addition, allof the information 
within the storage system ts placed within the 
Multics Ring Structure (see “Controlled Access 


Multics Virtual Memory 


and Storage System 


DIRECTORY SEGMENT 
NONDIRE CTORY SEGMENT 
DIRECT CONNECTION 


LINKED CONNECTION 


Hierarchical Storage System 


to Segments’’) a hardware-software feature that 
provices maximum security over information 
sharing. 


Each segment is identified by a user-assigned syim- 
bolic name (making use of the full ASCUE character 
set) as wellas by a unique, system-assigned iden- 
(ification. 

The fully specified name of any one segment is the 
list of subnames that reflect that sezment’s posi- 
tion in the directory hierarchy with respect to the 
root directory. This name, called a pathname, 
shows the “path” from the root directory to the 
specific segment and is the symbolic name by 
which the user must reference the segment. 


VIRTUAL MEMORY ENVIRONMENT 


Segmentation 

In the Multics System, all segments are directly 
addressable by the hardware. With the addressing: 
scheme used in the Multics processor, aff references 
fo information are mapped through descriptors 
(Segment Descriptor Words). These descriptors 
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are listed in a table (Descriptor Segment Table) 
that identifies segment attributes and defines the 
access u user can have to the segments. Most 
importantly, segmentation encourages users to 
view memory as a collection of independent linear 
core Memories, cach associated with a descriptor. 
A user program can create a segment by issuing a 
call to the system specifying as arguments the 
symbolic name of the segment plus additional 
information about who may or may not access this 
segment. Then the system constructs a descriptor 
according to the access information given by the 
originator of the segment. 


The originator has control over every segment in 
his directory: he can grant or restrict access to 
these segments in any way he chooses. In fact, he 
can grant different access privileges (read, write, 
execute, or null) to different users of the samme 
segment. 


Once the segment is created, the user program can 
address any item within the segment using name, I 
where “name” is the symbolic name of the seg- 
ment and ‘i’ denotes the place of the desired item 
within the segment. The maximum segment size is 
256K words (1048 576 bytes). 

Paging 

With most computer systems, the limiting physical 
resource is main memory. The amount of main 
memory Online is a major factor in determining the 
performance of a system. The problems associated 
with “swapping” large files into and out of,main 
memory severely limit system performance. Even if 
files were not all large, there would still remain the 
difficult problem of core management. Since the 
Multics System allows users to create and/or 
manipulate large segments, it is neither feasible nor 
desirable to have an entire segment in main mem- 
ory when in use. 

Therefore, in the Multics System, segments are 
automatically subdivided by hardware into “pages” 
with a fixed size of 1024 words. Additional address 
mapping at the hardware level allows the system to 
determine whether or not a page of a referenced 
segment is in main memory. 


If the page is not in main memory, a missing page 
exception occurs (called a “page fault’). The 
software system intervenes at this point and proc- 
esses the page fault by locating the desired page tn 
(he storage system and transferring it into main 
memory. During this phase, the process that gen- 
erated the page fault relinquishes control of the 
processor and the system dispatches the execution 
of another process (process multiplexing). Once 


the page does arrive in main memory, the system 
notifies the “waited”’ process and schedules tt for 
continued execution. 

By using this “demand paging” technique with a 
fixed page size, space allocation problems are sim- 
plified, and the cost performance factor of the 
system is significantly enhanced: only those seg- 
ment pages that are currently needed are in 
memory at any one time. 


USER ACCESS 


Direct Access to Files 


With most large-scale computer systems, the pro- 
grammer must interface with the file system 
through complicated Job Control Language (JCL). 
He also must know the specifications of the storage 
device on which his files reside and must issue and 
control (either explicitly or through macro specift- 
cation) his own I/O requests. 

The Multics System, with the aid of the virtual 
memory, requires no JCL, nor are users concerned 
with = oreven aware of | where and on what 
devices their segments reside. Instead, users com- 
municate with the storage system by asking the 
system to make available to then a segiient within 


their own virtual memory. 


Controlled Access to Segments 


Since all information is stored online in the Multies 
System and data can be accessed directly, access 
limits and controls are mandatory. The access con- 
trol mechanism in the Multics System is a highly 
sophisticated and reliable means for specifying the 
usage attributes of directories and other segments. 
There are two access control lists recognized by the 
system: one for directory segments, one for non- 
directory segments. These access control lists are 
carried in directory segments. 
Access modes for nondirectory segments are: 
read (r) datain the segment can be read 
write (w) datain the segment can be modified 
execute (e)  anexecuting process can transfer Co, 
and execute instructions in, this 
segment 
null (n) access to segment is denied 
Access modes for directory segments are: 
status (s) the attributes of segments, diree- 
tories, and links contained in the 
directory can be obtained 
modify (im). the attributes of existing segments, 
directories, and links contamed in 
the directory can be changed or 
deleted 
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append (a) new segments, directories, and links 
can be created in the directory 

null (n) access to directory is denied 

Access validation ts checked and enforced at the 
hardware level on cach memory reference. For 
example, if the originator of a data base decides to 
grant access to some user, he can issue a Multics 
command specifying ‘“‘read”’ access for that user. 

if that user is currently attempting to reference the 
data base, he is given access instantly. 


As a further control to accessing segments, the 
Multics System uses the Ring Structure. Logically, 
the Ring Structure ts cight concentric rings, cach 
representing a different level of virtual memory 
access rights. The highest level of privilege is the 
innermost ring, designated as ring zero; the outer- 
most is ring 7. Hach ring ts protected against uncon- 
trolled access by programs tn any ring with a higher 
number designation and thus a lower level of privi- 
lege. The Multics ring-handling mechanism is 
enforced at the hardware level. 


USER INTERFACE 

In using the Multics Storage System, the user has 
two available interfaces. With the first, the ‘““com- 
mand level” interface, the user can create and/or 
manipulate segments residing in various user direc- 
tories. In many time-sharing operating systems, the 
command level interface is supported by the 
physical editing of the “command” into various 
system tables in the operating system at system 
generation time. With this technique, the problems 
encountered while trying to expand the repertoire 
of the command language can be extreme. 

In the Multics System, however, there is no ““com- 
mand language’: everything executed at Multics 
command level is simply an object program from a 
system directory. When a user types a command at 
his terminal (e.g., create xyz), the system first 
interrogates the user’s own directory to see if the 
“create” program exists. If so, that version is exe- 
cuted. If not, the Multics System searches a set of 
system/user-supplied directories (called Search 
Directories) for the “create” program. The user 
also has the ability of expanding the default search 
directories to incitide other directories (possibly 
common to a specific project). 


The second user interface is available via program 
execution. Users’ object programs can issue call 
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statements to create and/or manipulate segments. 
The call statements themselves are of the standard 
PL/I form. Any program executed while at Multics 
command level can be called and executed inter- 
nally from within an object program. 


FEATURES 

Various features of both the Multics Virtual Mem, 
ory and the Storage System are summarized below, 
e All information stored in the Multics Virtual 
Memory is directly addressable provided the user 
has proper access rights. 

e Established protection rings allow users (0 effec: 
lively partition data within concentric ring struc- 
tures. 

e ‘Two or more users can share a single copy of 
data and/or programs in main memory. 

e Users may create “links” to other accessible 
segments of virtual memory in order to share data 
and/or programs. 

e Each user can specify various access rights lo lis 
own segments, even specifying different access to 
different users of the samc segment. 

e Movement of data between main memory and 
secondary storage and back is automatic, and is of 
no concern to the user. 

e Tree-structured storage hierarchy otters an 
organized scheme of classification and factlitites 
efficient search fora particular segment. 

e Use of directories within the storage system 
serves as a convenient place to look up addresses 
and access rights of other segments, 

e Access rights to a segment are checked by 
Multics hardware on every reference to the seg- 
ment. 

e Multics has no Job Control Language: everything 
executed at command level is merely a standard 
object segment. Thus, the “command language” 
cun be dynamically developed, ex panded, and 
tailored to individual installation — even individual 
user requirements. 


SYSTEM CONFIGURATION 


The functions herein described are applicable 
to ay Level 68 configuration. 


Specifications may change as design improvements are introduced. 


The Other Computer Company: 
Honeywell 
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SERIES 60 
LEVEL 68/DPS 


The Level 68/Distributed Processing System, with 
its Multics operating system, is an advanced large- 
scale computer system providing general purpose 
data processing service for business and scientific 
users. 


Level 68/DPS administration and operating 
features make its processing capabilities available 
with simplicity and ease. These features give the 
Level 68/DPS user more efficient control over 
online applications, improved response to individual 
user and group needs, and optimal utilization of all 
processing-related resources. 


INTERACTIVE ARCHITECTURE 


Level 68/DPS architecture is specifically directed 
toward interactive, online applications. It provides 
~ common interfaces for the implementation of these 
applications and for their administration and control 
as well. In addition, special online executives are 
not required to take advantage of these interfaces. 
Level 68/DPS employs standard, built-in tools for 
controlling the use of all system resources. 


MODULAR GROWTH 


Because of the Level 68/DPS hardware modularity, 
its users benefit from a long configuration life span, 
free from disruptive programming or operational 
changes. Level 68/DPS offers growth in small, cal- 
culated steps, paced with the growth of the user’s 
workload. Users can add more memory, new proc- 
essors, or front-end networking facilities according 
to specitic workloads. Level 68/DPS uniformity 
and consistency make it possible to grow from the 
smallest configuration to the largest without 
changing the Multics operating system, libraries, 
OF User programs. 


DECENTRALIZED ADMINISTRATION 


Fundamental in the Level 68/DPS design is the 
concept that productivity is tied directly to accessi- 
bility. The system's approach to administration ts 
consistent with that concept. Level 68/DPS admin- 
istration is decentralized, so that specific resources 
can be allocated to specific projects and accounted 
for accordingly. The project administrator can in 
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Administration and 
Operating Features 


turn allocate these resources to individual users 
within the project as necessary. 


Allowing remote users and user groups autonomy 
in their use of the system, and enabling them to 
control their own resources, gives them the oppor- 
tunity to more effectively deal with their day-to-day 
problems and varying processing requirements. 
Resource billing flexibility illustrates the advantage 
of Level 68/DPS decentralized administration. This 
billing can be automatic or on demand. Users on 
individual projects can even do their own sub-billing, — 
substitute their own billing algorithms, use different 
algorithms for different users, or install new 
algorithms dynamically. 


The Level 68/DPS administrator can establish up 
to eight separate work shifts, with different rates 
applied to each, encouraging use during slack — 
periods. Users can also be restricted to working on 
specified shifts, and these restrictions can be 
changed dynamically. Results: more efficient load 
leveling and more effective use of resources, 


RESOURCE UTILIZATION CONTROL 


Resource control in Level 68/DPS involves three 
primary areas: online storage utilization, physical 
access to system communication lines, and user job 
prioritization. Standard, built-in tools are used in 
each area. 


Online Storage Utilization 


Level 68/DPS enables an administrator to control 
the use of online storage on a “per project” basis. 
To maximize the use of storage resources, the 
administrator can allocate this storage to individual 
users within a project. 

Two techniques illustrate this control: 

e A storage quota, which prohibits the allocation 
of storage space when a specified workload fimit ts 
reached. 

@ An automatic data migration function, which 
allows data to be transferred to another medium 
when that data has not been accessed for a certain 
period of time. 
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Physical Access 


Controlling the physical access to Level 68/DPS, 
which includes restricting user groups to specified 
communications lines, also means controlling the 
workload mix on the system. The administrator 
can establish the maximum work units that the 
system will adequately support for the particular 
site. Issuing load unit weighting factors for each 
user cnsures that the system’s capacity cannot be 
exceeded to the detriment of its users. Different 
users can be issued different weighting factors to 
reflect different processing requirements. To ensure 
that specified privileged or high priority jobs will 
always be executed regardless of the total work- 
load on the system, certain users can be given 
guaranteed access status. 


User Job Prioritization 


Dynamic Scheduling 


User and job prioritization is accomplished via 
dynamic control of the priority scheduler. With 
this capability it is possible, for example, to add 
either more batch jobs or more interactive users to 
a system without negatively affecting the produc- 
iivity of time sharing programmers or transaction 


processing activities already in execution. 


Workload Balancing 


Level 68/DPS also incorporates a workclass concept 
which further ensures that the workload of certain 
users will not negatively affect the workload of 
others. Users can be grouped into classes and allo- 
cated percentages of processing capability. Regard- 
less of the total system workload, each group of 
users can be ensured a predetermined percentage 
of available central processor time. “‘Free time,” 
any time not utilized by a given workclass, is made 
available to other workclasses requiring more than 
their allocated time, maximizing central processor 
utilization. 


Deadline Scheduling 


This feature can be used for a limited number of 
users or applications to ensure that a predefined 
amount of processing time is available to these users 
after an interaction or job submission. Deadline 
scheduling ensures that batch jobs will finish within 
a specified time period, and that interactive users 
will receive a response within a predefined time 
span atter a transaction, regardless of the overall 
system workload. 

Changes to allocated resources, response characte r- 
istics, and batch job scheduling can be accomplished 
dynamically, or scheduled to happen automatically 
ata predetermined time. For example, a key appli 
cation can be deadline scheduled so that it is 
ensured a four-second response time during prime 


shift, but only an cight-second response time on 
second shift. 


ENVIRONMENT SHAPING 


Level 68/DPS environment shaping tools let you 
define interfaces to match users’ application proc- 
essing needs. These tools not only make it possible 
for nonexperts to use 68/DPS for problem solving. 
but also enable system administrators to succinctly 
define and limit what users can do with the system 
and what they must know to process their 
applications. 


The two major environment shaping tools are the 
limited service subsystem and the closed subsystem. 
@ The limited service subsystem enables the project 
administrator to define exactly those functions 
which the user cannot perform, all other system 
functions are available to that user by default. 

e The closed subsystem lets the administrator 


- define all the functions which the user can perform: 


all other functions are unavailable by default. 


The limited service and closed subsystems can also 
be used for defining new command languages and 
interfaces that convert “foreign” system commands 
into Multics operating system commands. ‘Phis can 
be useful to first-time Level 68/DPS users. In addi- 
tion, these subsystems allow nontechnical users to 
access the system via a highly simplified command 
interface. The capabilities afforded by these struc- 
tured interfaces do not have to be programmed; 
they can be established via simple commands. The 
administrator need only create a new file with the 
new restrictions or guidelines in it, and it is tmmedi- 
ately available to all authorized users. 


SIMPLIFIED SYSTEM OPERATION 


Level 68/DPS is surprisingly easy to operate, espe- 
cially considering its size and power. This relative 
case of use is duc largely to its dynamic recontigura- 
tion capability, simplified system maintenance, and 
responsive online metering and tuning capabilities. 


Dynamic Reconfiguration 


The dynamic reconfiguration capability of Level 
68/DPS is used to maintain continuity of processing 
service in the event of a malfunction in asystem 
component. If a failure occurs in a processor, for 
example, a single command automatically moves 
jobs and data in that processor to another unit, 
notifies the other system components of the mal- 
function, removes the processor front service, and 
reconfigures the remaining devices. Processors, 
memory, and peripheral devices can be added to or 
deleted from a configuration dynamically, via oper 
ator command. Failed pages of memory (4K-byte 
units) are automatically reconfigured by the oper: 
ating system whenever a double-bit error occurs. 
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This reconfiguration process can also assist in the 
testing of certain components. Users can 
dynamically remove certain devices from service, 
submit them to test and diagnostic routines and 
reconfigure them automatically, without inter- 
rupting processing service. Alternatively, devices 
can be dropped from service on one system, con- 
figured as a separate system, used for testing of new 
software, and then reconfigured in the original 


system without shutting down service. ‘ 


Level 68/DPS can run unattended, providing proc- 
essing service on holidays and weekends, without 
the need for operators. During unattended opera- 
tion, it can be run in the automatic reboot mode, 
and, in the event of a system failure, the system 
will automatically reinitialize itself so service can 
continue, 
Level 68/DPS can be operated from terminals inside 
or outside the computer room. Due largely to the 
system's extensive security, an administrator with 
the proper authority can log into the system and 
issue any command that could be issued from the 
main operator’s console. This gives Level 68/DPS 
greater operational flexibility, and frees it from 
relying on a single device (which might fail) for 
control functions. 


Level 68/DPS provides batch job status and con- 
trol capabilities as well as communication between 
system users. Operations messages can be sent to 
individual users; messages can be broadcast to the 
entire user community or to those on a particular 
project (or vice versa). 


System Maintenance Features 


For simplified maintenance, the Multics operating 
system does not require system or library gener- 
ation or edit. Multics software releases are also 
delivered patch-free. 


Users can easily install their own software or 
add programs to the time sharing library. New 
software can be installed without a system shut- 
down or link-edit. New compilers, applications, 
and procedures can be installed without inter- 
rupting processing service, even while users are 
using old versions. 


Metering and Tuning System Performance 


Level 68/DPS offers standard metering and tuning 
tools that allow an administrator to monitor and 
adjust system performance according fo specific 
needs and changing workloads. Using data that 

is constantly being gathered by the system itself, 
administrators can retune the system, move users 
from one processing class to another, or even 
change the percentage of processing power allo- 
cated to a user, depending on any number of 
variables and requirements. | 


This control is possible becuuse the administrator 
can analyze all facets of system performance from 
this constant flow of metering data. Some of thte 
information supplied includes: - 
e 1[/O and device activity data 

e Application response, processor utilization, 
communications, and I/O queuing 

e Average CPU time spent on certain functions, 
or used by certain applications 

@ State and characteristics of the communications 
lines attached to the system 

e EDAC (Error Detection and Correction) data 
associated with main memory hardware errors. 


PRE-SCHEDULED ADMINISTRATIVE 
FUNCTIONS 


A system facility called MEMO provides gener- 
alized capabilities for scheduling the initiation and 
execution of any program or set of programs. Phts 
allows the administrative or operational stalts 

to pre-schedule the running of administrative 
routines, such as billing. Scheduling can be sell 
repeating, such as scheduling a program to be run 
every Monday at 3 p.m. MEMO also allows either 
a precise definition of day/date/time (down to a 
microsecond level) or more general, logical 
definition (‘‘on Tuesday’’). 


INTEGRITY MECHANISMS 


To maintain file integrity in the event of a mal- 
function, Level 68/DPS has powerful file back-up 
mechanisms. 

e@ Anautomatic file archiver journatizes all 
changes to the file system and makes it possible 
to “roll forward” following a failure. 

@ Online file system integrity checks ensure a 
consistent, reliable file system. 

e Main memory flush-to-disk is an automatic 
data protection mechanism invoked after a system 
service interruption. All data in main memory 
which has been modified is written out to mass 
storage to reflect all changes made up to the CPU 
cycles prior to the failure. 

e Support of optional “shadow copy” logical 
volumes within the storage system. Volumes 
designated to have shadow copies automatically 
have spare devices assigned with copies of each 
physical volume. When updates are made to any 
of these devices, the copy ts updated as well. 

Ifa device fails, the system: automatically shifts 
to the copy without user interrupt. 


em 


Specifications may change as design improvements are introduced 
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‘To the user, a computer system is only as produc- 
tive as if is accessible. Based on human engineering 
design concepts, the Level 68/Distributed Process- 
ing System (68/DPS) uses interactive, remote ter- 
minal access - the most natural and convenient 
mode for the user — as the primary mode for 
programming. 


With the advent of Level 68/DPS, the computer is 
to be measured, not merely by hardware speeds, 
but by how well it helps solve a problem — from 
the very inception of that problem to its best solu- 
tion. Rather than wait for computer availability in 
a batch mode and submit many sequential jobs, a 
Level 68/DPS user prepares, compiles, and checks 
out programs in one continuous interactive terminal 
session. 

The Level 68/DPS interactive programming environ- 
nent provides a complete range of facilities that 
satisfies both the novice user and the professional 
programmer. Both enjoy appropriate software tools 
and both can work on the same system, protected 
by advanced hardware/software security features. 


The Level 68/DPS user interface provides an envi- 
_ ronment for a nearly unlimited scope of applica- 
tions regardless of size, complexity, or storage 
requirements. The multiprocessing, multiprogram- 
ming capabilities of Level 68/DPS and its diversity 
of languages and utility routines provide the user 
with ‘all the support needed. 


THE PROCESS, A UNIQUE CONCEPT 


When first accessing (logging into) a Level 68/DPS 
System, a user is allocated system resources in an 
environment termed a “process.” Specifically, the 
process is dynamically assigned space within the 
virtual memory (address space) and other system 
resources as required. As a result, each user views 
his process as if it were the only one in the system. 
In this environment, the user’s address space dy- 
namically grows and shrinks as program require- 
ments expand and contract — and the activity is 
totally transparent to the user and under control 
of the shared operating system. The system creates 
a process at log-in time and destroys it at log-out 
time on behalf of cach user. The user executes his 
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Interactive Programming 


Environment 


program and system commands in coexistence with 
the processes of all other logged-in users under the 
multiprogramming control of the Multics operat- 
ing system. 


SYSTEM FEATURES 


Some of the more important features of the 
Level 68/DPS interactive programming cnvi- 
ronment include: 

e Flexibility of environment shaping 

@ Information sharing in the Level 68/DPS 
Virtual Memory and Storage System 
Powerful language processors 

e Extensive support facilities and tools 
@ Powerful] command processor 

e Protection (security) 

@ Special user interfaces 


Flexibility of Environment Shaping 


The administration of a typical Level 68/DPS 
system includes one system administrator and 
multiple project administrators. Each project 
administrator defines the working environment 
for users in that project. He may give a user maXi- 
mum flexibility by allowing him complete control 
in creating his own initial process, or he may limit 
the user’s capabilities by restricting access to vari- 
ous software functions. 

The project administrator, then, defines the range 
of access each user has to system software func- 
tions. If the user has complete control of his own 
process environment, he may change parts of that 
environment and still be within the normal oper- 
ating conventions of the system. 


Information Sharing in the Level 68/DPS Virtual 
Memory and Storage System 


A Level 68/DPS system provides total sharing of 
data between users. In addition to sharing the oper- 
ating system’s modules, libraries, language proces- 
sors, and applications, users can even share user 
code and data. This is possible because all Level 
68/DPS compilers generate pure, reentrant code by 
default. 
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All procedures and data are contained within the 
Level 68/DPS Storage System and its associated 
virtual memory including facilities that provide the 
user with extensive control over file manipulation 
and file sharing. A user can specify which individ- 
uals may access his files, and by which mode of 
access. Access can be given to one user, to a group 
of users (project), or to a particular class of users 
(interactive or batch). 


The Level 68/DPS Storage System is supported by 
a powerful virtual memory, totally transparent and 
available to the user as needed. Virtual memory dy- 
namically expands and contracts according to user 
requirements and system resources. Thus, program- 
mers no longer need to be concerned about over- 
laying or partitioning program modules to satisfy 
limited main memory. resources. Instead, they can 
concentrate on program synthesis and on develop- 
ing the most efficient algorithm to solve their 
particular problems. 


Powerful Language Processors 


Level 68/DPS includes several fully compatible lan- 
guage processors. Foremost is a functional PL/I 
compiler that is used for both system programmers 
and applications programmers. The present PL/I 
compiler has undergone several major design iter- 
ations to become perhaps the most stable and re- 
liable PL/I compiler in existence. This is the same 
PL/I compiler that is used to produce the Multics 
operating system software itself, 95 percent of 
which is written in the PL/T language. 


Level 68/DPS supports COBOL-74. As with all 
Level 68/DPS compilers, COBOL programs can 
call programs written in any other language, 

thereby offering developers optimal flexibility. 


A complete FORTRAN compiler is available to 
satisfy any FORTRAN requirement as well as to 
facilitate the transfer of software from other com- 
puter systems. 


A BASIC compiler offers quick compilation and 
execution. It can be used as an independent lan- 
guage processor or in the simple time sharing sub- 
system called FAST. 


An APL language processor is also available. 
This is an interactive interpreter with exten- 
sive functionality. 


For users who find it necessary to write portions 
of their software in the language of the host com- 
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puter, Level 68/DPS includes the ALM (Assembly 
Language for Multics) assembler. This assembler 
supports all system requirements for interprogram 
communication. 

A program written in any language available on 
Level 68/DPS can also call programs written in 
another language by merely following (hat lan- 
guage’s calling conventions. For example. APL 
functions can call PL/I procedures. 

All compilers will automatically generate pure. 
reentrant code for users, making all programs 
immediately shareable. 


Extensive Support Facilities and Tools 


Stable and reliable software components within 
the Multics operating system provide numerous 
utility and support functions. Foremost among 
these are the text editors. These text editors have 
undergone several design iterations to inereiuse 
their reliability and sensitivity to human 
engineering requirements. Level 68/DPS text 
editors range from a simple editor supporting 
line-numbered files to advanced editors for expe- 
rienced users. 

Several extensive interactive debugging packages 
permit a user to analyze and correct a compiled 
program at both the original source level and the 
more specific machine-register level. 

Tools to measure performance permit the user to 
analyze a program’s behavior and facilitate the 
development of optimum applications software. 


Inter-user communication facilities, both mumedi- 
ate and deterred, permit online messages to be 
transmitted among users. In addition, online docu- 
mentation facilities provide the user with usetul 
word processing and document preparation tools. 


Powerful Command Processor 


The command processor, by which a user commu- 
nicates his requirements to the system, accepts 
input from a console, interprets the user's request, 
and invokes the software component to perform 
the desired function. The software component can 
be either system- or user-supplied: there is no dis- 
tinction at the command level. The command 
processor allows recursive, iterative commands 
and the embedding of function calls in the com- 
mand line. 


The command processor is a shared. replaceable 
module, written in PL/E. Therefore. i the project 


administrator desires, a user can be required to 
interface with a special version of the command 
processor (possibly user-created), thereby limiting 
the software requests or commands available to 
him. The command processor thus permits an ex- 
tremely wide range of interfaces to all system fa- 
cilities on either a controlled or open-ended basis. 
Tools are available to the user which allow the ab- 
breviation of commands or character strings for the 
development of personalized shorthand methods 
for directing program execution or accessing files. 
A facility also exists which allows users to program 
in commands with logical branching, variable main- 
tenance, file management, and 1/O control. This 
allows the development of complex applications 
without the involvement of language processors. 


The command syntax has been designed to provide 
us sophisticated and flexible a user interface as any 
user might possibly require for both a commutative 
and associative syntax form. However, simple 
requests have a simple form. 


SUMMARY 


@ The Level 68/DPS interactive programming envi- 
ronment provides facilities for both the novice and 
advanced user, for a wide range of applications. 

e@ The user’s virtual memory (address space) 
dynamically changes as program and data 
requirements change. 


e A unique process environment exists for each 
user, and this environment can be reshaped as 
needed. 

e Files are protected by user-specified access 
controls. . 

@ Level 68/DPS includes several language proces- 
sors: COBOL-74, PL/I. FORTRAN. BASIC. APE, 
and ALM. 

® The support facilities of Level 68/DPS include 
text editors, program debugging aids, performance 
meusurement tools, inter-user communication 
facilities, and online documentation aids. 

@ The Level 68/DPS command processor allows a 
wide range of interfaces to all system facilities 
either on a controlled or open-ended basis. 

@ Included within Level 68/DPS are special user 
interfaces that permit the development of other 
operating systems, closed subsystems, or fimited 
service facilities. 


SYSTEM CONFIGURATION 
The functions described herein are applicable to 
any Level 68/DPS configuration. 


Specifications may change as design improvements are introduced, 
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in today’s data processing environment computer 
security is a major concern. News storics tell of 
millions of dollars being stolen; company proprie- 
tary information being sold to competitors; and 
valuable information being deliberately destroyed 
or altered. In addition, there is growing concern 
regarding the protection of individual rights -- just 
what type of data can be compiled on an individual 
and how should such information be protected 
from unauthorized disclosure. At this time, laws 
protecting privacy carry both civil and criminal 
penalties. So the processing of sensitive information 
on an insecure system exposes companies to loss 
and fraud and, potentially, to civil and criminal 
proceedings. Secure computer systems have become 
a vital concern to the data processing industry. 


SECURITY MECHANISMS 


Level 68/DPS is the most secure computer system 
commercially available.!- Level 68/DPS and its 
Multics operating system provide security by a 
combination of methods unique in the industry. 
These methods are designed into, and are an inte- 
gral part of, the functioning of the system. Because 
the security mechanisms are implemented in both 
hardware and software and are applied universally 
to all user and system functions, they are far more 
difficult to subvert and security benefits are 
achieved with insignificant system overhead. 


Initial Access 

Initial access to the Level 68/DPS system is con- 
trolled by means of the user identification and 
password. 


The password mechanism is the first and most 
important line of security since it controls access 
to the system and verifies the user’s identity, upon 
which further access decisions are based. To ensure 
that users treat passwords with the care the system 
requires, Multics provides facilities to allow users 
to change passwords easily, to permit the System 
Security Administrator to compel periodic pass- 
word changes, and to require users to use system- 
generated, pronounceable passwords. 


When the system requests the entry of the pass- 
word at log-in time, the print mechanism of the 


Controlled Sharing 
and Security 


user’s terminal is turned off Cf the terminal has 
this feature) or a mask is printed, over which the 
password is typed. Thus, a password is never dis- 
played in readable form when it is entered. 


Passwords are stored in encrypted form within the 
system. When a user logs in, the typed password is 
similarly encrypted and the scrambled values are 
compared. 


Multics audits the usage of each password. It also 
counts incorrect passwords and types a message at 


log-in, telling the user how many times that pass- 


word has been given incorrectly since its last cor- 
rect entry. This alerts the user to the possibility that 
somcone has attempted to guess the password. 


The System Security Administrator can also set an 
entry In the system message table causing a messape 
to be sent whenever the user is logged in and some- 
one else attempts to log-in with the same vane, 
project, and password. 

Once verified and accepted by the system, the user 
is screened for information sharing (i.c¢.. the kind 
of access permitted to the file system and to user 
and system software). 


Information Sharing Controls 


Beyond the password control (which screens every 
person attempting to use the system), three addi- 

tional controls regulate access rights to all data and 
programs in terms of individual users and processes. 
These information controls are access control lists, 

access isolation mechanism, and the ring protection 
mechanism. 


ACCESS CONTROL LIST (ACL) 

The access rights for each segment are defined in tts 
access control list (ACL). Through the ACL, users 
can, at their own discretion, grant or deny access to 
their segments and directories. The ACL. specifies 
the users who have been granted access to the seg- 
ment and the mode of access allowed them. Users 
who do not appear on the ACE. have no access to 
the segment. Read, write, execute, and null! per 
missions may be specified for sepments Cboth data 
and program): status, modify, and append accesses 
may be specified for file system directories. Uhese 
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permissions may be specified by user name, by 
project, or by “instance” (whether a process is ab- 
sentee or interactive), or by any combination 
thereof. Classes of users can also be specified; for 
instance, all the users in a project, specific users in 

a project, or even all users in all projects. Access is 
initially verified by Multics software and is enforced 
by the hardware every time the segment is refer- 
enced thereafter. 


ACCESS ISOLATION MECHANISM 


The Access Isolation Mechanism (AIM) allows 
administrators of the system to define several 
levels of privilege, which the system itself en- 

forces rigidly. Enforcing the separation of these 
levels is totally independent of other access 
control or user action. This administrative mech- 
anism overrides user discretion in granting access 
and ensures privacy by preventing inadvertent or 
malicious disclosure of information between 
these privilege levels, even by those who “‘own” 
the information. | 


- AIM can be explained in simple terms. At log-in 
time, each process is assigned a sensitivity level 
and category (clearance) based upon the clearance 
of the user, the terminal, and the project. Also, 
every directory aid segment (object) within the 
storage system has a sensitivity level and category 
(classification) associated with it. If the clearance 
of a process is equal to the classification of the 
desired object, all access to the object (allowed by 
other access control mechanisms) is permitted. If 
the clearance of the process is greater than the 
classification of the desired object, read. execute 
or status permissions are allowed to the object 
(within constraints imposed by the other access 
control mechanisms). Finally, if the clearance of 
a process is less than the classification of the de- 
sired object, all access to the object is denied. 


AIM supports 8 clearance and 18 ‘“‘need-to-know” 
categories within each level. Access is granted or 

denied explicitly on the basis of the security classi- 
fication of a file or program and the security clear- 


ance of the user. This mechanism supplements the 
access control lists. Like the ACL mechanism. 
access i$ initially verified by Multics software and 
thereafter enforced by hardware at every reference. 
AIM can be invoked or disabled at the discretion of 
each Multics site. AIM also provides extensive secur- 
ity auditing controls to monitor user activity. 


RING PROTECTION 


The Level 68/DPS Security System uses a hardware- 
implemented, multilevel ring structure to control its 
users and to protect itself. The ring structure is a 
generalization of the two-state capability of other 
computer systems (master/slave mode, supervisor/ 
program State, etc.). With Muitics, the structure has 
been expanded to eight states or “rings of protec- 
tion” numbered 0 (most privileged) through 7 
(least privileged). The operating system resides in 
the most privileged rings, 0 through 2, while users 
generally operate in the less privileged rings, 3 
through 7. The segments of the operating system 
are in the most privileged rings to prevent uncon- 
trolled access or modification by the users of essen- 
tial system information. 


The basic rule is that users can only reference 
those segments in the same or less privileged 
ieveis than the ring in which they are cuireciitly 
executing. Access to higher privileged rings is 
only possible through a gate program. (This is 
analogous to master mode entry, supervisor call, 
etc.) The use of eight levels of protection rather 
than two allows user programs to take advantage 
of features for protection normally reserved for 
operating system software. 


"In a 1975 study conducted for the Air Force, the MITRE Corpora- 
tion concluded that Multics is the most secure operating system 
available. 

7 Null access is implied by default; that is, if a user does not issue a 
command granting another user access to a segment or directory, 
that other user cannot access the data in any way. However, null 
is useful in selecting a small number of individuals from a project 
to whom it is desirable to deny access. 


Specifications may change as design improvements are introduced, 
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LEVEL 68 


Multics PL/I is a language processor designed for 
commercial, scientific, and system programming 
applications. It was developed on Honeywell equip- 
ment in conjunction with the Massachusetts Insti- 
tute of Technology. Multics PL/I is the language 
defined by the American National Standards Insti- 
tute’s PL/I standardization committee and is sched- 
uled to become a standard. 


The compiled code is extremely efficient. The 
compiler was specifically designed for Multics and 
has been used to compile itself and most Multics 
software. 


ADVANTAGES 


Compilation and execution may be initiated © 
through absentee (Multics batch processing) or 
interactive mode. 

Programs written in PL/I ensure permanent com- 
patibility and ease of maintenance. 


Object modules are produced such that no relocat- 
able edit is required. The normal mode of opera- 
tion is to execute with dynamic linking and loading 
so that unreferenced data and unused programs are 
never loaded into main memory. 


Relocatable object permits the binding of sepa- 
rately compiled programs together into one seg- 
ment which has fewer pages than its unbound com- 
ponents. 


A run-time symbol table may be created by the 
compiler and used by the Multics debugger to 
make symbolic references to the program data at 
run time. There is no special checkout compiler 
and therefore no recompilation necessary to debug 
a program. 

An optional optimizer performs extensive optimi- 
zation of common expressions, conversions, and 
accessing code throughout a procedure or begin 
block. Register allocation is based on usage statis- 
ties gathered by the optimizer resulting in inte lli- 
gent use of pointer registers by the object code. 


CAPABILITIES 
PL/Lis a block-structured language that allows 
both internal and external names. This feature 


Multics PL/I 


facilitates the development and maintenance of 
modular PL/I programs. All procedures are recur- 
sive and sharable. 


Multics PL/I has a comprehensive set of data for- 
mats. These include eight distinct types of data: 
arithmetic, string, locator, format, label, entry, file, 
and area data. These formats give PL/I considerable 
descriptive power. 

[In addition to fixed-point and floating-point binary 
arithmetic, Multics PL/T provides variable-precision 
true fixed-point and floating-point decimal arith- 
metic of up to 59 decimal digits directly supported 
by hardware. Structure variables (similar to the 
hierarchical descriptions of COBOL) enable the 
programmer to explicitly define data structures as 
uny aggregate of elementary data formats. 
Dynamic allocation for scalar variables and aggre- 
gates is provided by the automatic, controled, and 
based storage classes. 

PL/I has powerful bit string and character string 
handling capabilities. Operations and functions are 
performed on either fixed or vartable length 
strings. The extended instruction set of the central 
processor is fully utilized to perform character- and 
bit-string operations, picture editing, as well as 
decimal arithmetic and arithmetic base con- 
versions. 

Arithmetic, string, or pointer variables declared 
with the “unaligned” attribute are packed tnto the 
minimum number of bits, giving the programmer 
complete control over the packing of structures 
and arrays. 

Through the use of pointer-valued Multics func- 
tions and PL/I based variables, a user can easily 
access any bit in the entire virtual memory. 


Declaration of initialized arrays and data structures 
is permitted. Components can be freely interspersed 
in PL/I programs to aid in program documentation. 


Multics PL/E utilizes the full ASCTE character set 
defined in American National Standards Tnstitute 
standard X3.4-1908. Both uppercase and lowercase 
letters can be used to form names up to 256 char- 
acters long. This offers the user greater naming 
flexibility. 
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The % include macro provides for the inclusion of 
program text without the use of a preprocessor. 


Complete symbol listings show how each name was 
declared, as well as its attributes, and its address 
allocation. 


The compiler diagnoses over 350 errors, giving 
complete, readable diagnostics that include the 
erroneous statement or name. Warning diagnostics 
are given for common mistakes such as an 
undeclared name or implicit conversion of data 
types. 


PL/I programs may call procedures written in other 
languages or vice versa provided they observe the 
interface conventions, as is the case with the other 
compilers in the system. 


Multics PL/I and FORTRAN compilers have simi- 
lar options, program listings, and error messages, 
and in fact share the same compiler code genera- 
tion module phase and are, therefore, completely 
compatible. 


PL/I input/output facilities provide a convenient 
method of constructing and maintaining large files 
within the virtual memory or on removable media. 


The PL/I ‘‘do” statement and “if” statement allow 
the programmer to construct flexibie program iogic 
without the proliferation of statement labels. 


The “ton” statement of PL/I permits the program- 
mer to make arrangements to handle special condi- 
tions which arise during execution. These condi- 
tions can arise aS the result of errors recognized by 
the hardware or be signalled by the program itself. 
Multics virtual memory, coupled with PL/I pointer 
data, facilitates the programming of complex list 
processing techniques. 


OTHER MULTICS FEATURES 


Multics PL/I is a powerful language on a powerful 
system. One of the most advanced computer sys- 
tems in the world, Multics offers extensive security 
provisions, virtuai memory, interactive progratii- 
ming environment, hierarchical storage of data, and 
highly functional administrative control features. 
For more information on the Honeywell Multics 
System, contact your Honeywell Marketing repre- 
sentative. | 


SYSTEM CONFIGURATION 


The functions herein described are applicable to 
any Level 68 Multics configuration. 


Specifications may change as design improvements are introduced. 
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Multics APL is an advanced version of the APL 
programming language - an interactive system for 
use with Honeywell's large-scaic Level 68/DPS 
computers. Multics APL is a general purpose lan- 
guage that is both easy to learn and powerful to 
use. It is interactive by design — problems can be 
attacked swiftly, error messages are informative, 
errors can be corrected quickly and easily — all 
within the APL environment. 


APL brings the full scope of data processing to 
business and technical problem solvers who may 
have little programming experience. 

It is particularly well suited for business and scien- 
tific applications requiring the manipulation of 
arrays of data. Typical business applications include 
financial modeling, investment analysis, sales fore- 
casting, and payroll and budget analysis. Scientific 
applications include linear programming, regression 
analysis, and pipe stress networks. 


BENEFITS 

Multics APL offers substantial benefits: 

@ Provides powerful language statements for 
easier problem solving 

e Provides a set of tools for interactive develop- 
ment, debugging, and execution of programs 

-@ Offers data processing capabilities for any level 
of programming expertise 

@ Reduces time for programmer system develop- 
ment thereby increasing programmer productivity 


FEATURES 


The following features make Multics APL partic- 
ularly attractive: 

@ File access capabilities 

* Ability to store APL functions and programs 
for later execution 

e Ability to automatically start a function 
executing when program is loaded 

e Powerful execute operator which interprets a 
character string operand and may produce a 
character string result 

e Ability to diagnose errors in a longer, more 
explanatory format to assist new APL users 
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e Support of ASCII terminals and a variety of 
APL terminals (especially graphics terminals) 

e@ Several preprogrammed workspaces, including 
a fully documented, tutorial course for user self- 
instruction in Multics APL 

e ASCII-compatible character set 

e Accurate floating point computations 

e Sizable arrays and unlimited workspace in 
virtual memory 

e File system that does not require knowledge 
of job control language 

e Full security and integrity protect programs 
and data from unauthorized use or modification 
® Convenient interface to other Multics pro- 
gramming languages 

e Software to convert from IBM to Multics 
format ; 

e Ability to access Multics data bases via 

PL/I subroutines 


SYSTEM DESCRIPTION 


System operation is straightforward. At a termt- 
nal, the user simply calls Multics APL, and then 
types an expression to be evaluated. The Multies 
APL interpreter performs the caiculations, prints 
the results, and awaits a new input line. The results 
of an expression evaluation can also be assigned to 
a variable and retained from line to line for use in 
subsequent evaluations, 


In addition, a sequence of calculations can be 
stored as a function to be recalled by name and inter 
preted as a single entity. The result of the function 
is processed as though the entire sequence of expres- 
sions had just been entered at a terminal. Results 
from any form of expression evaluation may be 
printed at the terminal, presented in graphic form 
(on a suitable terminal), formatted into a tabular 
report, or stored in a file for subsequent retrieval 
and processing by Multics APL, or other program- 
ming languages. The entire state of any Multics APL 
session may be saved for subsequent use, tneluding 
all variable names, their current values, and stored 
program functions. 

The APL language employs a special character set 
(normally requiring a special APL terminal) in 
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which most operations are represented by a sini? 


character. Besides the more common operations 
(add, multiply, etc.), Multics APL provides single- 
character operations for more complex functions, 
such as sorting, random number generation, and 
matrix inversion. Some of these functions are 
suited particularly to the manipulation of large or 
complicated data arrays. 


Access to.a special APL terminal is not required; 
Multics APL can be used from an ASCII terminal 
through a special set of over-strike conventions. 
Unlike similar conventions in any other APL, this 
convention preserves the visual appearance of APL 
programs. It is as easy to read Multics APL pro- 
grams on an ASCII terminal as it is on an APL 
terminal. Multics APL supports all APL terminals — 
including EBCDIC, Correspondence, APL/ASCII 
bit-paired, and APL/ASCII typewriter-paired. 

The Multics APL character set is a compatible 
superset of ASCII; hence, character data can be 
easily and efficiently shared between APL and 
other Multics programming languages. 


By using powerful APL language elements, the 
user can devote full attention to solving the prob- 
lem at hand. Multics APL helps the user avoid the 


rr 


complexities of the individual programming steps 


required and the interrelationships of the system 
operation. For example, inversion of a matrix, 
which would involve many program statements 
with nested loops and indexing in other pro- 
gramming languages, is accomplished with a 
single-character operation in Multics APL. 


Multics APL can call APL functions written in 
PL/I, which, in turn, can call programs written 

in BASIC, COBOL, or FORTRAN. The PL/I 
coded function can be niladic, monadic, or 
dyadic, and can optionally return a result. It can 
diagnose the same errors any APL operator can 
diagnose and can call out to any other Multics 
subroutine or system interface. 

Thus, this facility enables the APL user to get at 
any system interface or application program by 
writing a short PL/I program to transform the call. 
This means the Multics APL user can easily inter- 
face to the Multics Graphics System, the Multics 
Relational Data Base Manager, and other packages. 


SYSTEM REQUIREMENTS. 


Multics APL runs under the control of the Multics 
Operating System on all models of Level 68/DPS. 


Specifications may change as design improvements are introduced, 
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Honeywell’s Multics Data Base Manager (MDBM) 
provides Level 68/DPS users with a powerful, 
versatile, efficient, and easy-to-use data base man- 
agement capability. MDBM functions as a subsystem 
of the Multics operating software, and makes use of 
the Level 68/DPS virtual memory and file manage- 
ment subsystems. It is designed to support concur- 
rent access to up to 64 data bases of up to 180 
billion characters each. 


Much of the versatility of MDBM derives from the 
fact that it offers the user a choice of two different 
methods for structuring and manipulating a given 
data base: a relational approach and a procedural, 
CODASYL-standard (Conference on Data System 
Languages) approach. While all data is stored in a 
relational format, two differing interfaces are 
visible to the user. 


The relational technique greatly simplifies the job 
of programmers and end-users, as a detailed knowl- 
edge of the logical structure of the data base is not 
required to use it. MDBM performs the retrieval 
function automatically. For example, a person 
seeking data writes a statement that defines the 
nature of the data required; he does not provide 
specific instructions as to where and how the data 
is to be retrieved. 


At the same time, the procedural approach is 
available to those programmers who are familiar 
with and prefer CODASYL data base techniques. 


MDBM is the industry’s first fully implemented 
relational data base manager commercially available 
from a computer manufacturer. It is also the only 
data base manager to offer both relational and 
CODASYL capabilities in the same system. 


MDBM BENEFITS 

The Multics Data Base Manager provides the follow- 
ing benefits: 

e Jmproved programmer productivity. — Program- 
mers can accomplish data base tasks with much 

less effort when employing MDBM’s relational 
capabilities. 

e New end-user flexibility Because of the sim- 
plicity of relational techniques, end-users can inde- 
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pendently retrieve data base information without 
support from the programming staff. 


e Ease of maintenance — The tasks of entering and 
changing data are greatly simplified. 

© Data storage efficiency » One data base system 
can meet the needs of an entire organization without 
redundant files and effort. 

e /mproved data accuracy ~- The elimination of 
redundancy ensures consistent information with 
fewer chances of error. 


e Ensures data integrity and securitv — Inherent 
Level 68/DPS integrity/security features are avail- 
able to the MDBM user. 


MDBM FEATURES 


The Multics Data Base Manager includes the follow- 
ing Significant system design features: 


Relational interface — Multics Relational Data Store 
(MRDS), a component of the data base manager, 
represents data relationships by means of tormal 
algebraic entities. A user structures and accesses 
data files without concern for how or where the 
data is actually stored. As a result, the user's task 

is greatly simplified. 

Procedural interfuce ~- Multics Integrated Data 
Store (MIDS) provides an interface with the data 
base manager following CODASYL standards. 
MIDS is a subset of Honeywell’s I-D-S/Uf data base 
management system. This capability is highly tlex- 
ible, allowing the building of network, hierarchical, 
sequential, or cyclical structures. 

Language independence — Any Level 68/DPS 
supported language may be used to access MDBM 
facilities, including COBOL-74, PL/I, FORTRAN, 
APL, BASIC, and Assembler. Well-defined CALL 
statements are employed. 

Independence of processing modes — MDBM sup- 
ports all processing modes such as transaction proc- 
essing, Gime sharing, batch, remote job entry and 
direct access. All of (hese modes cun be supported 
simullancously. 

Controlled sharing — Alluser data (as well as oper- 
ating system software, libraries, and user code) ts 
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potenuaily shareable at the discretion of its owner. 
Since all Level 68/DPS language processors generate 
only pure reentrant code, no copies or reloads are 
required. 

Data definition and program independence — Data 
definition is an independent function. In most cases, 
changes to the data base will not require repro- 
gramming of user applications. 

Query capability — A special MDBM query language, 


termed LINUS (Logical INquiry and Update System), 


provides comprehensive query capabilities. 

Online access and update — Records may be easily 
added, modified, or deleted online. Multiple users 
may access the same data base concurrently. MDBM 
can be invoked by as many users as are allowed on 
the system. 


Concurrent access and update controls — Update 
privileges can be assigned to individual users or 
classes of users. To ensure integrity, users may 
specify exclusive use of the data base when it is 
opened; or, if sharing a data base, users may tem- 
porarily reserve a record type and associated sets 
during critical update operations. It is possible for 
privileged users to specify exclusive update, which 
locks out all other processes attempting to access 
the data base; and it is also possible to specify ex- 
clusive retrieval, which locks out all updaters from 
the data base. 


Report generation — The Level 68/DPS Report 
Generation Language (RGL) facilitates the produc- 
tion of reports, in conjunction with either the 
LINUS query language or ASCII files. 

Automatic data recovery and restart — MDBM uses 
Level 68/DPS backup/retrieval mechanisms. They 
provide recovery of a data base after system failure 
or when a disk has been damaged. 

Monitoring — Tools exist to monitor data base usage 
from various aspects, 

Dynamic tuning — A system administrator can view 
current monitoring data from a terminal and dynam- 
ically alter parameters to affect performance. 

Data integrity and security — Level 68/DPS is the 
only system where all data integrity/security fea- 
tures are implemented in both software and hard- 
ware. MDBM derives its superior integrity/security 
characteristics not from provisions within the data 
base manager, but rather from design features of 
the Multics operating system and Level 68/DPS 
hardware. 


TERMS DEFINED 


The relational and CODASY L approaches have 
developed separately, so that terms used in de- 
scribing one approach differ substantially from 
those used for the other. Table | is provided to 
bridge this terminology gap. 


TABLE 1 - TERMS 


Traditional Honeywell MDBM 
Data Processing Relational CODASYL 
Terminology Approach Approach 


Record type, class or 
format (physical) 


physical record} physical record 
relation record type 


ltuple = record occurrence 


Record type, class or 
format (logical) 
Record occurrence 
Field/element 

Range of values (the 
set of all values associ- 
ated with a field type) 
Total data base defi- 
nition 


attribute data element/field 


domain 


largely ignored 


schema 


data model 
data submodel | subschema 


DATA BASE DEFINITION PROCESS 


Figure | illustrates the MDBM data base definition 
process. Users may create and access a data base 
using either the MRDS or MIDS interfaces with the 
following restrictions: 


Program view of data. 
base 


e A data base created using the MIDS facility may 
be accessed only with MIDS programs. 

e A data base created using the MRDS facility may 
be accessed only with MRDS programs. 

The definition of a data base in MDBM is accom- 
plished by the user or data base administrator de- 
fining either: 

e A data model tor a relational data base. 

e Aschema for a CODASYL data base. 

The data descriptions are not directly referenced 

by user application programs, and each application 
program may have a different view of the data base. 
The definition of that portion of the total data base 
affecting a particular program is accomplished by 
defining either: 

e A data submodel. 

e A subschema. 


Partial views (data submodels or subschemas) must 
be proper subsets of the total data base definition. 
In the case of a relational (MRDS) data base, the 
data model definition file contains the complete 
description of the different data elements to be 
found in the data base. This is the data base admin- 
istrator’s view of the data base. The data submodel 
definition file contains the definitions of those re- 
lations and attributes of interest to a specific pro- 
gram. This is the user’s or programmer's view of the 
data base. The data submodel is defined tindepend- 
ently of the data model and no binding is done 
until application program execution open-time. 
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Data types for data submodel attributes are not __ 
defined within the data submodel; they are defined 
within the application program. They may differ 
from the data types defined in the data model for 
the corresponding attribute name. Allowable data 
types (in PL/I terms) are real and complex fixed 
binary, real and complex floating binary, real and 
complex decimal, varying and nonvarying bit string, 
and varying and nonvarying character strings. 


Binary data types may be single or double precision. 


When a data base administrator defines an MIDS 
data base, both a schema and a data model defini- 
tion file are automatically created (Figure 1). The 
schema definition file contains only information 
associated with a CODASYL data base relevant to 
the data structure/organization of that data base. 
Schema entries contain data and network structure 
information while data model entries contain de- 
scriptions of the data elements in the data base. 


Again, data descriptions in the schema definition 
file are not directly referenced by user application 
programs. The user or data base administrator de- 
fines that portion of a total data base of interest 

to a particular program by use of a subschema. A 
subschema definition contains only the application 
program view of the data base and is the MIDS 
counterpart of the data submodel in MRDS (Gust 
as the schema is the MIDS counterpart of the data 
model). 


In practice, MIDS controls structural definitions, 
whereas MRDS controls data definitions. 
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Figure 1. MDBM Data Base Definition 


THE RELATIONAL DATA STORE 


The Multics Relational Data Store (MRDS) pro- 
vides an integrated set of functions to support the 
description and processing of a wide varicty of data 
base structures. Data independence is achieved 
through the use of data model/submodel concepts. 


The MRDS user defines a data model using a tech- 
nique known as “normalization” or “reduction 

to third normal form.” The process of normalizing 
a data base consists of a subjective process per- 
formed by the data base administrator whereby 
complex relations are reduced or transformed into 
simpler relations without loss of information or. 
dependencies. The rationale for using the third 
normal form relational model derives from certain 
anomalies which can otherwise occur in a relational 
data base. 

The data model or data base definition is defined, 
accessed, and maintained by the data base admin- 
istrator. The administrator, working in conjunction 
with application users, defines a valid data sub- 
model to be referenced by each application pro- 
gram. Under certain user-controlled circumstances, 
a user may act as his/her own administrator and 
deal directly with the data model. The data sub- 
model provides each application program with its 
view of a data base and must be a proper subset of. 
the data model. 


The definition of a data submodel may differ from 
the data model in several ways: 


e Attribute names may differ. 


e Attributes may be omitted from a data model 
relation. 
e Attributes may be ordered differently within a 
relation. 


e Relations may be omitted. 


A data submodel definition may be created sepa- 
rately or in conjunction with an application program. 
Several data submodels may be associated with the 
same data model. Several data submodels may be 
referenced by the same application program. Data 
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submode! definitions may intersect. 

When defining a relation in a data model or sub- 
model, it is necessary to specify which attributes or 
fields are to be used as components of the primary 
key (i.e., key attributes). Bach tuple or record 
occurrence must be identifiable by some non-null 
primary key value which must be unique. Phe ex- 
pression for defining a relation and its altributes 
resembles the format used in most relational 
literature. | 

The “open” procedure is called when the MRDS user 
wishes to access the data base. At this time the data 
model and submodel are resolved. Figure 2 tlus- 
trates access activity. 
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The MRDS Language Processor provides the user 
with the following capabilities: 

e Open and close a data base defined by a specified 
data submodel. 

e Retrieve data based on a flexible selection capa- 
bility. 

e Modify and delete items within a data base. 

e Enter new information into the data base. 


e Perform the above while allowing for the maxi- 
mum possible concurrent access capability. 


The data manipulation capability provided is rela- 
tionally complete. That is, it possesses the full 
power of the relational calculus. Any query expres- 
sible in first-order predicate calculus is expressible 
in an MRDS selection mechanism. 


THE MULTICS INTEGRATED DATA STORE 


The Multics Integrated Data Store (MIDS) provides 
a CODASYL language interface to the functions re- 
quired to support the description and access to 
CODASYL data base organizations, including hier- 
archies and networks. Data independence between 
the physteal data base and application programs is 
achieved through use of schema and subschema con- 
cepts as specified by CODASYL. 

The schema deseribes the total data base and ts 
defined and maintained by the data base adminis- 
trator. The administrator, working with prospective 
users, defines valid subschemas to be referenced by 
individual application programs, 
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Figure 2. MDBM Data Base Access 
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The subschema must be a proper subset of the 
schema. The subschema contains only the infor- 
mation necessary to define the data required by the 
application program. 

MIDS relies primarily on access control lists rather 
than privacy locks or passwords to provide security 
at the level of the record and set. Concurrent update 
protection is provided at the record type and set 
name level. 


The following specific CODASYL schema defini- 
tion functions are supported by MIDS: 

e A data base, records, fields, and sets may be given 
names. 

e Record location mode may be specified as CALC 
or VIA SET. (All records in MIDS must be given a 
unique control key field even if the location mode 
is VIA SET.) 

e Field types may be BINARY, DECIMAL 
SIGNED, or CHARACTER. 

e Sets may be defined. 

e ORDER of set insertion is defined as PERMA- 
NENT INSERTION and DUPLICATES NOT 
ALLOWED for SORTED ORDER. 

e Set members may be ordered as FIRST, NEXT, 
LAST, PRIOR, or SORTED BY DEFINED KEYS. 
e Set membership is defined as MANDATORY and 
AUTOMATIC. | 

« Sct selection may be THRU OWNER IDENTI- 
FIED BY CALC-KEY or BY APPLICATION. 
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A subschema may describe only that portion of the 
entire data base (i.e., schema) which is of particular 
interest to the application program. (A schema may 


be shared by a number of subschemas.) A subschema 


may differ from the schema in the following ways: 


e Field names may be renamed or omitted from a 
subschema record. 

e Field names may be ordered differently within 
records. 

e Field types may differ from the corresponding 
schema ficld type {although field types are not de- 
fined in the subschema, per se). 

e Records may be renamed or omitted. 

e Sets may be renamed or omitted. 

Several subschemas may be referenced by an appli- 
cation program and subschema definitions may 
intersect. Subschema record, field, and set names 
must be associated explicitly with schema record, 
field, and set names. Field types are defined in the 
using application program. 


At execution time the validity of the subschemii is 
verified and the views of the data base represented 
by the schema and subschema are resolved. 


The following basic functionality is provided by 
MIDS Data Manipulation Language (DML): 
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READY 
STORE 
ERASE 
FIND 
GET 
MODIFY 
FINISH 
KEEPX 
FREEX 


It is possible to READY multiple subschemas within 
one process. 


Specifications may change as design improvements are introduced. 
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LINUS (Logical Inquiry and Update System) isa 
powerful and easy-to-use facility for accessing - 
data bases from a remote terminal. It provides 
complete data base management capabilities, 
including both retrieval and update operations. 
LINUS functions as a subsystem of the Multics 
operating software and uses Multics Relational 
Data Store (MRDS) for data base access, LINUS 
is used by a variety of business professionals, — 
including inventory control personnel, budget 
planners, geologists, and school administrators. 


LINUS uses a high level, nonprocedural data 
selection language called LILA (LInus LAnguage). 
LILA allows people, who are not trained program- 
mers, to solve problems by working with data bases. 
The user views the data base as a simple set of 
tables, consisting of rows and columns; LILA 
provides an easy way to “look up” information 
contained in those tables. 


System operation is straightforward. At a terminal, 
the user simply calls LINUS and types a request 

for LINUS to open the desired data base. If the 

_ user is unsure of how to proceed, he types “‘help”’ 
for assistance. After the data base is opened, the 
user may call LILA and type a selection expression 
specifying the data to be accessed. LILA then proc- 
esses the selection expression, retaining it in a form 
suitable for reference by subsequent LINUS 
requests. 


After selecting the data, the user may type a LINUS 
request to manipulate it. Among the actions which 
can be performed are display the data on a terminal, 
write a formatted report, place the data into a 
Multics file for later use, and update the data base. 
The data may be acted upon by several manipulation 
requests, and new data may be specified at any time 


by typing a new LILA selection expression. 


BENEFITS 


LINUS is easy to use. With three short words even 
an inexperienced computer user can get information 
from a data base using LINUS. ‘These words are 
“select,” “from” and “where.” For example, a 
telephone directory can be thought of as being a 
table with three columns of information: name, 
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address, and phone number. To find the phone 
number of John Smith, the user scans the namie 
column for “Smith John” and reads the value from 
the phone number column in the same row. With 
LINUS, using LILA, this operation is described as: 
select number . 
from phone book 
where name = “Smith John” 


Studies and experience have shown that inex- 
perienced users can attain substantial competence 

in LINUS within a matter of hours. 

Other benefits include: 

e Direct End-User Access -- Using LINUS, the 

user can independently retrieve and update data 
base information without support from the 
programming staff. 

e Support of Unforeseen Requirements — The 
LINUS user can immediately respond to unexpected 
information requirements by interactively selecting 
the desired data via a terminal, without writing a 
program. 

© Complete Selection Capability — LINUS is 
powerful and “complete” in the sense that the user 
can select any information contained within the 
data base using LILA, subject to security constraints. 


FEATURES 


@ Complete Data Base Functionality - LINUS 
provides facilities enabling the user to add and 
delete rows from a data base table, to modify 
column values in a table, to define temporary tables 
for personal use, and to retrieve information from 
one or more specified tables. 

@ Macro Facility — A parameterized macro facility 
allows the user to invoke previously saved sequences 
of LINUS requests. This allows the tailoring of an 
environment to an individual user. 

e LILA Line Editor A BASIC-like line editor 
built into LILA simplifies construction of data 
selection expressions. 

© Built-in and User-defined Functions — Built in 
functions allow the user lo determine sums, averages, 
and counts, of data as well as to search on such 
items as partial character string values, and rounded 
or truncated numeric values. In addition, there is 
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a well detined method for dynamically adding 
functions required by local users. 

e Internal Variables — The LINUS user can assign 
retrieved data values to internal variables, allowing 
subsequent data selections to be dependent upon 
previously retrieved data. 

e Help Facility — A help request available within 
LINUS provides information on how to use its many 
facilities. The user need only type “linus’’ to invoke 
the subsystem, and “help” in order to begin using 
LINUS. 

e Table of Contents — The contents (tables and 
columns) of the data base may be displayed 
allowing a person unfamiliar with the structure and 
content of the data base to use LINUS. 

@ Report Writing Capability -. Formatted reports 
from retrieved data can be created using either 

the Multics Report Program Generator (MRPG) 

or the WORDPRO facility, Lister. Either facility 
can be invoked with a simple LINUS request. 

e Multics - Any Multics capability can be invoked 


LINUS 


from within the LINUS subsystem. Some possible 
uses of this feature are sorting retrieved data via 
the Multics sort facility, or editing retrieved data 
with one of the Multics text editors. 

@ Data Base Creation The user can create a 
private data base via easy-to-use MRDS commands. 
Special documentation oriented to the LINUS user 
makes this process especially simple. The data base 
can then be maintained and accessed using LINUS. 
e Data Sharing, Integrity, and Security — LINUS 
fully utilizes MRDS and Multics facilities for con- 
current usage control, data base security, and data 
base backup and recovery. 


SYSTEM REQUIREMENTS 


LINUS operates under Multics on any Scries 60, 
Level 68/DPS configuration. The availability of 
MRDS is a prerequisite for LINUS operation. 


Specifications may change as design improvements are introduced. 
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WORDPRO, another dimension of Honeywell’s 
powerful Leve! 68/Distributed Processing System — 
Multics — provides a comprehensive set of software 
tools for developing a wide range of documents 
online. And because WORDPRO is integrated 
within the Multics operating software, its users can 
develop and maintain documents ranging from sim- 
ple form letters to complex technical presentations 


simultaneously with other data processing activities. 


The end result can be rapid turnaround time, im- 
proved productivity, and optimal quality in docu- 
ment preparation. 


WORDPRO BENEFITS 


Since WORDPRO is an integral part of Level 68/ 
DPS, it offers advantages unavailable with other less 
comprehensive word processing systems: 


e Ease of Use — People with little or no knowledge 
of Level 68/DPS or word processing can easily use 
WORDPRO for numerous text processing tasks. 
Merely by following WORDPRO-generated instruc- 
tions, even inexperienced users can readily perform 
functions such as text entry and simple editing. 

e Security — The security provided by WORDPRO 
is the same security provided for all information 
stored in the Multics virtual memory. Because 
WORDPRO-prepared documents reside in the vir- 
tual memory, they receive the same high degree of 
security afforded any other job, file, or program. 


e Document Management Tools - WORDPRO docu- 


ment management tools make it easy to maintain 
documents online or offline in a standard format. 
These tools can be used for document file manipu- 
lation, archiving, document linkage, etc. The same 
tools which control 68/DPS storage also control 
WORDPRO documentation. 

e Tailored Environments — Level 68/DPS lets the 
WORDPRO user define exactly how text process- 
ing is to occur. Unlike other systems, WORDPRO 
users specify the types of terminals to be used 

and the various document formats to be accepted. 
Interfaces to these devices can be changed at any 
lime. 

@ Selectable Administration — The WORDPRO 
user is not bound by a restrictive administrative 
approach. Each site can define what the individuals 
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Word Processing System 


(WORDPRO}) 


using the system (terminal operators and document 
administrators) need to know. The roles of these 
individuals can be large or small depending on how 
a user’s document processing activities are estab- 
lished. 

* Maximum Equipment Utilization - WORDPRO 
can help users make maximum use of slack com- 
puter time. Rather than have the system sit idle 
when not processing data, WORDPRO can use 

this extra time efficiently for text processing 

thus maximizing equipment utilization. 

e Total Integration with Data Processing - Within 
Level 68/DPS, word processing and data processing 
are fully integrated. Data and text files created and 
maintained by WORDPRO can be accessed and 
used by data processing applications. Conversely, 
files created and maintained by data processing 
applications are available to WORDPRO users, all 
without special programming or conversions. 


DEVICE FLEXIBILITY 


Any terminal accepted by Level 68/DPS can be 
used for word processing. Users need not purchase 
special equipment or dedicate terminals for 
WORDPRO applications. If one set of terminals 

is used for input and update, other devices can be 
used for output. Text entered from one terminal 
can be modified by another without regard to 
terminal characteristics. 


TEXT ENTRY TOOLS 


Several tools are provided with WORDPRO for 
the entry of new text. With these tools, an indi- 
vidual with little or no prior word processing 
experience can easily power type raw text into 
the system for later update or incorporation into 
a document. 

The DOCUMENT routine is a simplified interface 
to all the WORDPRO tools. It lets the user pre- 
define document formats, and automatically 
generates the final document with paragraph and 
page numbers, footnotes, table of contents 
(optional), ete. Paragraph editing is provided to 
allow paragraph addition, modification, and de- 
letion with automatic renumbering. Whole para- 
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graphs may be inserted from a prepared list of 
paragraphs. Speed typing, hyphenation, and all of 
the quality control and document management 
tools are also provided within the DOCUMENT 
interface. Once processed through DOCUMENT, 
the text can be printed at a terminal or high- 
speed printer. 


SPEEDTYPE — similar to typing shorthand — 
allows users to specify abbreviations for input of 
character sequences. When a document is printed, 
these abbreviations are automatically expanded 
to their predefined strings. The result is fewer 
key strokes typed, higher document quality, and 


reduced storage requirements. 


TEXT EDITING 


Input text can be modified using either of the 
WORDPRO editors: cursor or string. Using a CRT 
device and the cursor editor, terminal users can 
simply type over portions of a document which 
are to be changed. 


String editing, which is more comprehensive than 
cursor, enables the user to manipulate strings of 
characters in a text for editing or updating pur- 
poses. String editing functions range from simple, 
line-oriented editing to context-oriented searching 
and replacement. 

Together, the WORDPRO cursor and string editors 
give the user the freedom to select the desired 

mix of simplicity and comprehensiveness. 


DOCUMENT FORMATTING AND HYPHENATION 


The WORDPRO formatter provides document for- 
mat control. In addition to margin and page length 
control, the formatter handles automatic page and 
paragraph numbering, widow processing, table of 
contents and index generation, font and forms 
control, artwork placements, and automatic hy- 
phenation. Further, the formatter can control: 


e Headers/Footers — Up to 20 headers and footers 
can be specified. These can be page numbers, copy- 
rights, logos, or the current date. These need only 
be specified once; they will be inserted automat- 
ically thereafter. 

® Footnotes -- They are automatically generated, 
numbered, inserted, and maintained with the 
proper page. If footnotes are added or deleted, 

the remaining ones are automatically renumbered. 
e@ Pagination - Pages can be automatically num- 
bered in Arabic or Roman numerals, in upper- or 
lowercase, or alphabetically. 


QUALITY CONTROL 


WORDPRO incorporates an extensive set of qual- 
ity control tools for detecting and rentoving typo- 
graphical errors from docuinents. First, SPEED- 
TYPE can be used to correct typos at entry time. 
For example, common typing errors such as “hte” 
instead of “the” can be corrected by predefining 
the former string as an abbreviation to be ex- 
panded to the latter. Or, long difficult-to-spell 
words can be abbreviated, thus eliminating fre- 
quent misspellings. 


Online dictionaries can also be used to detect 
misspelled words within a document. WORDPRO 
offers a dictionary containing over 50,000 cor- 
rectly spelled English words. The content of a doc- 
ument is compared with the dictionary’s entries, 
and any words not found are entered in an error 
file or printed at the user’s terminal. Multiple 
dictionaries can also be developed. For example, 

a dictionary of technical jargon or frequently used 
non-English words could be established so that - 
these types of words would not be considered 
misspelled. Dictionaries can be shared, if desired, 
or used as private versions. Dictionaries can also be 
added to or deleted from as desired. 


Change bars can be generated on documents under- 
going review. A complete list of changes (line-by- 
line) can also be generated in a separate file of 
notes. Additionally, text comparison programs 
allow review of new documents against older 
versions. 


LIST PROCESSING 


The generation of personalized form letters and 
billing statements can be accomplished using 
WORDPRO’s list processing capabilities. Lists of 
mailing addresses can be used concurrently by 
multiple terminal operators to create these types 
of documents with key pieces of information in- 
serted at various points. These list processing tools 
can also be used in conjunction with other 68/DPS 
facilities (such as the data base manager) to supply 
current up-to-date account information for monthly 
statements, billings, etc. Mailing labels or pre- 
addressed envelopes can also be generated. 


ARTWORK 


WORDPRO can be used to generate diagrams, 
organization and flow charts, and logos. These 
figures can be included as part of the final, pritited 
copy of a document. 
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OUTPUT CONTROL 


Numerous devices can be used to print review cop- 


ies or final documents. A terminal operator may 
request that a segment of text be output ona 
local or remote printer, thereby freeing the input 
terminal for other work. Line printers, plotting 
terminals, and CRT devices can all be used for 
output. 


High-speed offline printers, such as the Honey- 
well Page Printing System, can be used in con- 
junction with WORDPRO to generate multiple 
copies in multiple colors with preprinted forms. 
Special forms control capabilities for line printers 
and plotting terminals permit documents to be 
printed on multipart, tear-away, or peel-off forms. 


Computer output microfilm/microfiche interfaces 
are available for generating, distributing, or archiv- 
ing documents on micro media. Documents can 
also be stored in files online, or maintained off- 
line on tape, cards, etc. 


PHOTOCOMPOSITION 


The WORDPRO design incorporates a photocom- 
position interface to allow the generation of con- 
trol information for automatic typesetting devices. 
This photocomposition facility is table-driven so 
that a variety of devices can be easily supported 
by simply modifying control tables. 


ELECTRONIC MAIL 


WORDPRO provides its users with a compre- 
hensive, secure electronic mail facility. This 


facility allows message-switching networks to be 
established. Users can send and receive mail rang- 
ing from short, immediate messages to lengthy 
memos or documents, over these networks. Secur- 
ity is provided via a personal or shared mailbox 
area which is subject to extensive access control 


checking. Electronic mail can be the basis for the 


automation of a business’s entire in-house mail 


_ operation, eliminating the need for couriers. 


ACCESSIBILITY OF OTHER FACILITIES 


Because WORDPRO is an integrated part of 
Level 68/DPS, its users can access other facil- . 
ities. For example, financial data stored ina 
68/DPS data base can be selectively inserted into 
a WORDPRO-generated document to produce an 
up-to-date monthly or quarterly statement. The 
68/DPS Interactive Graphics package can be used 
to generate artwork for WORDPRO documents, 
and the Multics file management and manipula- 
tion tools can be used with online WORDPRO 
files. 


ADMINISTRATIVE TOOLS 


Implemented on a project-oriented basis, 
WORDPRO can easily control the use of proc- 
essing resources, access to documents and tools, 
billing for usage, etc. Users can be restricted to 
certain functions, or allowed access to full capa- 
bilities of WORDPRO. All the administrative 
controls provided by Level 68/DPS are applicable 
to WORDPRO administration. 


Specifications may change as design improvements are introduced. 
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The Multics Graphics System provides a general 
purpose interface through which user or applica- 
tion programs can create, edit, store, display, and 
animate graphic material. 


FEATURES 


e High degree of terminal independence 

e Ability to define graphic objects that may be 
used repeatedly in higher-level objects 

e Powerful editing facilities for graphic objects 
e Ability to store graphic objects permanently 


TERMINAL INDEPENDENCE 


The Multics Graphics System is organized into two 
distinct parts: the terminal-independent portion 
and the terminal interfaces. 


User and applications programs communicate 
exclusively with the terminal-independent portion 
of the system. This ensures that: 


e User programs and applications routines are not 
restricted fo one particular terminal type, but can 
use whatever graphic terminal is available. 

e Users are not isolated from each other because 
of the types of terminals they use, but may freely 
use each others” programs on their own terminals. 
e Graphic applications may easily be transferred as 
new and improved terminals become available. 

The Multics Graphics System can accept new types 
of graphic terminals with a minimum of coding. In 
most cases, the user need only specify the special 
characteristics of his terminal in a table and con- 
struct a program to perform any code conversion 
necessary. No special [/O programming is required. 
He may then use any existing program or graphic 
file and obtain comparable results on his own 
device. 


STRUCTURED GRAPHIC OBJECTS 


Rather than treat graphic data as an unstructured 
collection of graphic elements (much as a sketch 
could be considered an unstructured collection of 
lines and points), the Multics Graphics System 
deals with structured descriptions of objects. 


Multics Graphics 


System 


Sample Graphic Displays . 
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‘This organization has three advantages: 


e Natural representation of most objects can be 
made in terms of their own inherent organization. 
For example, a piston, a complex object in its own 
right, may be treated as an elemental object within 
a graphic description of an engine. 

e Subpictures can be shared, thereby eliminating 
redundancy. 

e Powerful global picture editing capabilities are 
possible. 


PERMANENT GRAPHIC STORAGE 


Facilities are provided so that the user can attach a 
name to any graphic object and store it in a Multics 
segment. Such objects may be used at any time by 

any user authorized to access the segment. 


TERMINAL-INDEPENDENT GRAPHIC 
TRANSMISSION 


Graphic information is transmitted in a well- 
defined terminal-independent code. This code may 
be interpreted by a Multics program and converted 
to the appropriate codes to drive a graphic 
terminal; or it may be transmitted directly to an 
intelligent graphic device that performs its own 
interpretation, with a corresponding increase in 
efficiency. It may also be directed to a Multics file 
and “played back” on any graphic device to form 
background scenes or standard ‘“‘canned”’ pictures. 


Graphic input sent to a Multics system is converted 
from its original format into this code before being 
forwarded to the terminal-independent portion of 
the system. 


SYSTEM COMPATIBILITY 


Programs originally written on other computers 
that make use of the most widely used set of 
graphic subroutines may, with minimal conversion, 
interface in the same way with the Multics 
Graphics with System. Interfaces to mimic other 
popular graphics systems are easily constructed. 


DYNAMIC AND INTERACTIVE GRAPHICS 


When used with a terminal of sufficient intel- 
ligence, the Multics Graphics System can perform 
real-time graphic operations, such as dynamic 
animation, incremental picture update, local pic- 
ture editing under control of the terminal, and 
sophisticated graphic input. 


SYSTEM REQUIREMENTS 


The Multics Graphics System is applicable to any 
Level 68 Multics configuration. 


Specifications may change as design improvements are introduced. 
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The Level 68/DPS (Multics) electronic mail facility 
offers its users direct, online, person-to-person 
distribution of text. It handles mail ranging from 
brief memos to multivolume documents and deliv- 
ers that mail immediately to data terminals or on- 
line mailboxes. It is one of the many productive 
personal computing features of the Level 68/DPS. 


Honeywell’s electronic mail facility operates in 
conjunction with WORDPRO, the Level 68/DPS 
word processing system, and automates the crea- 
tion, distribution, and updating of text information. 
Electronic mail can significantly reduce the volume 
of paperwork generated in a typical large organiza- 
tion, dramatically reduce the cost of disseminating 
documents, and avoid the delays normally associ- 
ated with physically generating and transporting 
documents. 


‘The Level 68/DPS electronic mail facility offers 
definite advantages: 


e@ Each user can create a private “mailbox” — 
u Special storage segment for mail delivery, or 
mailboxes may be shared for group use. 


e Any terminal recognized by the Level 68/DPS 
can send or receive electronic mail — no special 
devices are required. 

@e A user can access his mailbox from any Level 68/ 
DPS recognized terminal at any location. 

Electronic mail provides such distinctive functions 
as: 


e Immediate or deferred delivery of messages, text. 
and other mail 


e Broadcast delivery to groups of users 


@ Selective delivery only to persons with a ‘‘need 
to know” 


@ Asecure mailbox facility, protected by the full 
range of stringent security controls in Multics sys- 
tem software and hardware, to guard mail from 
unauthorized access 

e Simple commands to prescribe the mailbox 
aecess and mail functions allowed for specified 
Users 

e Many document management tools for text 
manipulation and storage 


Multics Electronic 
Mail Facility 


VARIETY OF USES 


The Level 68/DPS electronic mail facility has a 
myriad of business uses. For instance, a large 
organization typically functions from a number 
of widely separated locations corporate head- 
quarters, research and engineering facilities, manu- 
facturing plants, sales and service branches, and 
test facilities. Because of these widely separated 
facilities, the slow delivery of vital documents by 
conventional mail often results in communication 
problems. Also, the cost of document reproduction 
and delivery can be considerable. Flectronic mail 
can help solve these communication problems in 
the foliowing ways. 


e After creation, editing, and formatting via 
WORDPRO, text is distributed instantly to recip- 
ients at many locations, thereby reducing distribu- 
tion delays ‘and costs. 

e Online, two-way messages can be exchanged 
between Level 68/DPS users. 

@ Mail can be delivered for immediate display at a 
recipient’s terminal or stored in his mailbox, when 
the recipient’s terminal is occupied with an urgent 
task or not logged onto the system. 

e Automatic acknowledgment-of-mail receipt can 
be requested by the sender. 

e Asingle. online copy of a large document can 

be maintained for remote perusal, avoiding the 
problems of reproducing and distributing printed | 
copies, 

In addition, management of messages and docu- 
ments is aided through a variety of tools in Multies. 
Indexed, ordered archives of past messages can be 
created, searched, updated, appended. or deleted as 
desired. The archives can be searched for key sen- 
tences or phrases, extra copies can be printed, and 
old messages and mail can be periodically and auto- 
matically deleted when no longer needed. 


Text can be examined and updated from several 
locations at once. For example, dtrtag a contract 
negotiation, a master copy of the contract can be 
maintained online vie WORDPRO. All interested 
parties -- the customer, along with marketing, cng 
neering, legal, finanee, ete. can simultaneously 
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review and comment via electronic mail without 
the delays involved in the conventional mailing of 
contract review copies. 


SECURE MAILBOX 


The Level 68/DPS electronic mail facility utilizes a 
secure online mailbox approach. Each user can have 
a private mailbox under his home directory, or a 
group of users can share a common mailbox to 
receive mail. The contents of cach user’s mailbox 
and archive is protected by the extensive security 
controls of the Multics virtual memory and file 
management functions. When mail! arrives in a user’ 
mailbox, the recipient is immediately notified, if 
his terminal is online to the Level 68/DPS system. 
The user can then selectively display the mail with 
simple commands, save it in mail archive files, or 
delete it. 


TYPES OF ACCESS 


Any combination of six different types of mailbox 
access can be prescribed for a single user or a group 
of users: 


seemitle ne AN 4 
inailbox. All users are usually given add perm! 


® add — allows the addition of new messages to a 
ssion 

so they can send mail. 

e delete -- allows the deletion of any message In a 

mailbox; usually retained for use only by the mail- 

box owner. 

® read — allows the user to select and read any mes- 

sages in a mailbox; usually retained for use only by 

the mailbox owner. 

® own — allows the sender to read, modify, or delete 

messages he originally sent to a mailbox, but doesn’t 

allow access to other messages in the mailbox. 

@ status — allows a mailbox owner to check on the 

number of his messages, their sender, length, date, 

ete., in his mailbox, without actually reading them. 

® wakeup — allows a message to be sent to a mail- 

box for immediate display, when the mailbox owner 

is accepting messages. Users can be given this permis- 

sion to allow direct, user-to-user communication. 


SIMPLE COMMANDS 
The electronic mail facility utilizes standard 


Level 68/DPS system commands to send messages 
and to deliver and receive mail. Other standard file 


manipulation tools allow maintenance of online 
message and mail files. These commands can be 
issued either in full or abbreviated format. Repre- 
sentative Multics commands include: 


@ ynail (il) - sends mail to another system User or 
prints the mail in the owner’s mailbox. A user’s 
mailbox is created automatically under the home 
directory the first time this command ts invoked. 
Optional arguments allow selective display or dele- 
tion of mail. 

® acceptunessage (am) ~ restores the immediate 
display of messages as received: cancels the deter 
message command. 

e immediate message -- requests immediate display 
of any messages in an owner’s mailbox or of any 
messages received while the owner’s terminal is on- 
line, unless the defér message is in effect. 

© defermessage (dm) - prevents any Messages 
received while a-user’s terminal is online from 
immediate display and stores them in the user's 
mailbox. 

@ print message (pm) -- displays any messages 
received in a user’s mailbox during a period when 
messages are not being accepted. 

@ send message (sm) © sends a message which ts 
designated by the person and project identities 
that follow the command. 


@ sendunessagecgcknowledge sends a message to 
the system user(s), designated by person and proj- 
xt identifiers that follow the command. When the 
message is displayed at the recipient's terminal, an 
acknowledgment is returned to the sender. 


SYSTEM REQUIREMENTS 

The electronic mail facility is integrated with the 
other facilities of the Level 68/DPS, including data 
base management, text entry and editing, document 
formatting, list processing, artwork generation, 
photocomposition, output control, archive storage 
tools, and administrative tools. Electronic mail fune- 
tions on all performance levels of the Level 68/DPS 
system. 


A a EOE TY SYS 


Specifications may change as design improvements are introduced, 
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In 1964 planning began on the development of a proto- 
type of a computer utility. The aspirations for this system, 
named Multics (for Multiplexed Information and Comput- 
ing Service), were described in papers presented at the 
7965 Fall Joint Computer Conference. Implicit in those 
papers was the expectation of a later examination of the 
development effort. From the present vantage point, how- 
ever, it is clear that a definitive examination is beyond 
possibility in a single paper; only some of the possible top- 
ics can be discussed. First we will review the goals, history 
and current status of the appearance of the Multics system 
to its various classes of users. Finally we will describe some 
of the insights which have come out of the development 


~ MULTICS: 
The first seven years 


F. }. Corbaté 
Massachusetts Institute of Technology 
Cambridge, MA 


C. T. Clingen 
Honeywell Information Systems Inc. 
Cambridge, MA 


/. H. Saltzer 
Massachusetts Institute of Technology 
Cambridge, MA ’ 


FROM THE EDITOR 


This overview and history of Multics will be of excep- 
tional interest because it fills most of the requirements 
for being used as a ’’software factory’, a term that | 
coined in 1968. It is in fact used for that purpose within 
Honeywell Information Systems -- in the construction of 
software systems. 

It is particularly pleasing to note that the punch card 
has disappeared from the view of Multics programmers, 
although not from everywhere else. As Dr. J. Rabinow 
(of Optical Character Recognition fame) has observed, 
if it does it will be the first product he has seen die while 
on an upward curve of usage! 


This article appeared in the Proceedings of the 1972 AFIPS 
Spring Joint Computer Conference, and is republished (not 
reprinted) here with the permission of AFIPS and the au- 
thors. The work reported herein was sponsored in part by 
Project MAC, an M.I.T. research program sponsored by the 
Advanced Research Projects Agency, Department of De- 
fense, under Office of Naval Research Contract Number 
N00014-70-A-0362-0001. Reproduction is permitted for 
any purpose of the United States Government. 
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INTRODUCTION 


In 1964, following implementation of the Compatible Time- 
sharing System (CTSS) [1,2] serious planning began on the 
development of a new computer system specifically orga- 
nized as a prototype of a computer utility. The plans and 
aspirations for this system, called Multics (for Mu/tiplexed 
/nformation and Computing Service), were described in a 
set of six papers presented at the 1965 Fall Joint Computer 
Conference [3-8]. The development of the system was un- 
dertaken as a cooperative effort involving the Bell Telephone 
Laboratories (from 1965 to 1969), the Computer Depart- 
ment of the General Electric Company (subsequently ac- 
quired by Honeywell Information Systems Inc.), and Project 
MAC of M.1.T. 

Implicit in the 1965 papers was the expectation that there 
should be a later examination of the development effort. 
From the present vantage point, however, it is clear that a 
definitive examination cannot be presented in a single paper. 
As a result, the present paper discusses only some of the 
many possible topics. First we review the goals, history and 
current status of the Multics project. This review is followed 
by a brief description of the appearance of the Multics sys- 
tem to its various classes of users. Finally several topics are 
given which represent some of the research insights which 
have come out of the development activities. This organiza- 
tion has been chosen in order to emphasize those aspects of 
software systems having the goals of a computer utility 
which we feel to be of special interest. We do not attempt 
detailed discussion of the organization of Multics; that is the 
purpose of specialized technical books and papers (for ex- 
ample, the essential mechanisms for much of the Multics 
system are given in books by Organick [9] and Watson [10)). 


GOALS 


The goals of the computer utility, although stated at length 
in the 1965 papers, deserve a brief review. By a computer 
utility it was meant that one had a community computer 
facility with: 


@ Convenient remote terminal access as the normal 
mode of system usage. 


® A view of Continuous operation analogous to that of 
the electric power and telephone companies. 


@ A wide range of capacity to allow growth or con- 
traction without either system or user reorganization. 


® An internal file system so reliable that users trust their 
only copy of programs and data to be stored in it. 


B Sufficient control of access to allow sciective sharing 
of information, 
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@ The ability to structure hierarchically both the logic al 
storage of information as well as the administration of 
the system. 


® The capability of serving large and small users without 
inefficiency to either. 


@ The ability to support different programming environ. 
ments and human interfaces within a single system 


@ The flexibility and generality of system organization 
required for evolution through successive waves of 
technological improvements and the inevitable 
growth of user expectations. 


In an absolute sense the above goals are extremely difficult 
to achieve. Nevertheless, it is our belief that Multics, as at 
now exists, has made substantial progress towards achieving 
each of the nine goals (to the best of our knowledge, the only 
other attempt to comprehensively attack all of these goals 
simultaneously is the TSS/30 project at IBM [11,12,13)). 
Most importantly, none of these goals had to be compro- 
mised in any important way. 


HISTORY OF THE DEVELOPMENT 


As previously mentioned, the Multics project got underway 
in the Fall of 1964. The computer equipment to be used was 
a modified General Electric 635 which was later named the 
645. The most significant changes made were in the pro- 
cessor addressing and access control logic where paging and 
segmentation were introduced. A completely new General: 
ized Input Output Controller was designed and implemented 
to accommodate the varied needs of devices such as disks, 
tapes and teletypewriters without presenting an excessive 
interrupt burden to the processors. To handle the expected 
paging traffic, a 4-million word (36-bit) high-performance 
drum system with hardware queueing was developed. The 
design specifications for these items were completed by fall 
1965, and the equipment became available for software 
development in early 1967. 

Software preparation underwent several phases. The first 
phase was the development and blocking out of major ideas, 
followed by the writing of detailed program module spec tfi 
cations. The resulting 3,000 typewritten pages formed the 
Multics System Programmer’s Manual and served as the 
starting point for all programming. Furthermore, the software 
designers were expected to implement their own designs. As 
a general policy PL/I was used as the system programming 
language wherever possible to maximize lucidity and main- 
tainability of the system [14,15]. This policy also increased 
the effectiveness of system programmers by allowing each 
one to keep more of the system within his grasp. 

The second major phase of software development, well 
underway by early 1967, was that of module implementa 
tion and unit checkout followed by merging into larger ag 
grepates for integrated testing. Up to then most sottware and 
hardware difficulties had been anticipated on the basis ot 


previous experience. But what gradually became apparent 
as the module integration continued was that there were 
gross discrepancies between actual and expected perfor- 
mance of the various logical execution paths throughout the 
software. The result was that an unanticipated phase of de- 
sign iterations was necessary. These design iterations did not 
mean that major portions of the system were scrapped with- 
out being used. On the contrary, until their replacements 
could be implemented, often months later, they were cru- 
cially necessary to allow. the testing and evaluation of the 
other portions of the system. The cause of the required 
redesigns was rarely ‘“‘bad coding”, as most of the system 
programmers were well above average ability. Moreover the 
redesigns did not mean that the goals of the project were 
compromised. Rather three recurrent phenomena were ob- 
served: 1) typically, specifications representing less-impor- 
tant features were found to be introducing much of the 
complexity, 2) the initial choice of modularity and interfac- 
ing between modules was sometimes awkward, and 3) it 
was rediscovered that the most important property of al- 
gorithms is simplicity rather than special mechanisms for 
unusual Cases. (“In anything at all, perfection is finally at- 
tained not when there is no longer anything to add, but when 
there is no longer anything to take away...” -- Antoine de 
Saint-Exupéry, Wind, Sand and Stars, Quoted with permis- 
sion of Harcourt Brace Jovanovich, Inc.) 

The reason for bringing out in detail the above design 
iteration experience is that frequently the planning of large 
software projects still does not properly take the need for 
continuing iteration into account. And yet we believe that 
design iterations are a required activity on any large scale 
system which attempts to break new conceptual ground 
such that individual programmers cannot comprehend the 
entire system in detail. For when new ground is broken, it is 
usually impossible to deduce the consequent system behav- 
ior except by experimental operation. Simulation is not par- 
ticularly effective when the system concepts and user 
behavior are new. Unfortunately one does not understand 
the system well enough to simplify it correctly and thereby 
obtain a manageable model which requires less effort to 
implement than the system itself. Instead one must develop 
a different view: 

@ The initial program version of a module should be 
viewed only as the first complete specification of the 
module and should be subject to design review before 
being debugged or checked out. 


B® Module design and implementation should be based 
upon an assumption of periodic evaluation, redesign, 
and evolution. 


In retrospect, the design iteration effect was apparent even 
in the development of the earlier Compatible Timesharing 
System (CTSS), when a second file system with many func- 
tional improvements turned out to have poor performance 
when initially installed. A hasty design iteration succeeded 
in rectifying the matter but the episode at the time was 
viewed as an anomaly perhaps due to inadequate technical 
review of individual programming efforts. 


CURRENT STATUS 


In spite of the unexpected design iteration phase, the Multics 
system became sufficiently effective by late 1968 to allow 
system programmers to use the system while still developing 
it. By 1969 October, the system was made available for 
general use on a “‘cost-recovery”’ charging basis similar to 
that used for other major computation facilities at M.I.T. 
Muiltics is now the most widely used timesharing system at 
M.I.T., supporting a user community of some 500 registered 
subscribers. The system is currently operated for users 22 
hours per day, 7 days per week. For at least eight hours each 
day the system operates with two processors and three 
memory modules containing a total of 384 K (K=1024) 36- 
bit words. This configuration currently is rated at a capacity 
of about 55 fairly demanding users such that most trivial 
requests obtain response in one to five seconds. (Future 
design iterations are expected to increase the capacity rat- 
ing.) Several times a day during the off-peak usage hours the 
system is dynamically reconfigured into two systems: a re- 
duced capacity service system and an independent develop- 
ment system. The development system is used for testing 
those hardware and software changes which cannot be 
done under normal service operation. 

The reliability of the round-the-clock system operation 
described above has been a matter of great concern, for in 
any online real-time system the impact of mishaps is usually 
far more severe than in batch processing systems. In an 
online system especially important considerations are: 


B the time required before the system is usable again 
following a mishap 


@ the extra precautions required for restoring possibly 
lost files 


@ the psychological stress of breaking the interactive 
dialogue with users who were counting on system 
availability 


Because of the importance of these considerations, careful 
logs are kept of all Multics ‘crashes’ (i.e., system service 
disruption for all active users) at M.I.T. in order that analysis 
can reveal their causes. These analyses indicate currently an 
average of between one and two crashes per 24 hour day: 
These crashes have no single cause. Some are due to hard- 
ware failures, others to operator error and still others to 
software bugs introduced during the course of development, 
At the two other sites where Multics is operated, but where 
active system development does not take place, there have 
been almost no system failures traced to software. 
Currently the Multics system, including compilers, com- 
mands, and subroutine libraries, consists of about 1500 
modules, averaging roughly 200 lines of PL/I apiece. These 
compile to produce some 1,000,000 words of procedure 
code. Another system measure is the size of the resident 
supervisor which is about 30 K words of procedure and, for 
a 55 user load, about 36 K words of data and buffer areas, 
Because the system is so large, the most powerful mainte- 
nance tool available was chosen--the system itself, With all 
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of the system modules stored online, it is easy to manipulate 
the many components of different versions of the system. 
Thus it has been possible to maintain steadily for the last year 


or so a pace of installing 5 or 10 new or modified system | 


modules a day. Some three-quarters of these changes can be 
installed while the system is in operation. The remainder, 
pertaining to the central supervisor, are installed in batches 
once or twice a week. This online maintenance capability 
has proven indispensible to the rapid development and 
maintenance of Multics since it permits constant upgrading 
- of the user interface without interrupting the service. We are 
just beginning to see instances of user-written applications 
which require this same capability so that the application 
users need not be interrupted while the software they are 
using is being modified. 

The software effort which has been spent on Multics is 
difficult to estimate. Approximately 150 man-years were 
applied directly to design and system programming during 
the “development-only” period of Table |. Since then we 
estimate that another 50 man-years have been devoted to 
improving and extending the system. But the actual cost of 
a single successful system is misleading, for if one starts 
afresh to build a similar system, one must compensate for the 
non-zero probability of failure. 


THE APPEARANCE OF MULTICS 


Tm Ae 8 hee re 
yu 


its USERS 


Having reviewed the background of the project, we may 
now ask who are the users of the Multics system and what 
do the facilities that Multics provides mean to these users. 
Before answering, it is worth describing the generic user as 
“viewed’”’ by Multics. Although from the system’s point of 
view all users have the same general characteristics and 
interface with it uniformly, no single human interface repre- 
sents the Multics machine. That machine is determined by 
each user’s initial procedure coupled with those functions 
accessible to him. Thus there exists the potential to present 
each Multics user with a unique external interface. 

However, Multics does provide a native internal program 
environment consisting of a stack-oriented, pure-procedure, 
collection of PL/I procedures imbedded in a segmented vir- 
tual memory containing all procedures and data stored on- 
line. The extent to which some, all, or none of this internal 
environment is visible to the various users is an administra- 
tive choice. 


System Development Only 
CTSS 1960-1963 
Multics 1964-1969 


The implications of these two views--both the external 
interface and the internal programming environment -are 
discussed in terms of the following categories of users: 

@ System and user application programmers responsi- 
ble for writing system and user software. 


Administrative personnel responsible for the manage- 
ment of system resources and privileges. 


The ultimate users of application systems. 


Operations and hardware maintenance personnel re- 
sponsible, respectively, for running the machine 
room and maintaining the hardware. 


Multics as Viewed by System and 
Subsystem Programmers 


The machine presented to both the Multics system program 
mer and the application system programmer is the one with 
which we have the most experience; it is the raw material 
from which one constructs other environments. It is worth 
re-emphasizing that the only differentiation between Multics 
system programmers and user programmers is embodied in 
the access control mechanism which determines what on 


lina 
tte 


information can be referenced: therefore, what are ap 
parently two groups of users can be discussed as one. 
Major interfaces presented to programmers on the Multics 
system can be classified as the program preparation and 
documentation facilities and the program execution and 
debugging environment. They will be touched upon briefly, 


in the order used for program preparation. 


@ Program Preparation and Documentation 


The facilities for program preparation on Multics are typical 
of those found on other timesharing systems, with some 
shifts in emphasis. (See the Appendix.) For example, pro 
grammers consider the file system sufficiently invulnerable 
to physical loss that it is used Casually and routine to save 
all information. Thus, the punched card has vanished from 
the work routine of Multics programmers and access to 
one’s programs and the ability to work on them are provided 
by the closest terminal. 


Development + Use Use Only 
1963-1965 1965-present 


1969-present 


Table 1. A comparison of the system development and use periods of CTSS and Multics. The Multics development period is not significantly longer than 
that for CTSS despite the development of about 10 times as much code for Multics as for CTSS and a geographically distributed staff. Although reasons 
for this similarity in time span include the use of a higher-level programming language and a somewhat larger staff, the use of CTSS as a development tool 


for Multics was of pivotal importance. 
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AS another example, the full ASCII character set is em- 
ployed in preparing programs, data, and documentation, 
thereby eliminating the need for multiple text editors, several 
varieties of text formatting and comparison programs, and 
multiple facilities for printing information both online and 
offline. This generalization of user interfaces facilitates the 
learning and subsequent use of the system by reducing the 
number of conventions which must be mastered. 

Finally, because the PL/I compiler is a large set of pro- 
grams, considerable attention was given to shielding the user 
from the size of the compiler and to aiding him in mastering 
the complexities of the language. As in many other timeshar- 
ing systems, the compiler is invoked by issuing a simple 
command line from a terminal exactly as for the less ambi- 
tious commands. No knowledge is required of the user re- 
garding the various phases of compilation, temporary files 
required, and optional capabilities for the specialist; explana- 
tory ‘’sermons” diagnosing syntactic errors are delivered to 
the terminal to effect a self-teaching session during each 
compilation. To the programmer, the PL/I compiler is just 
another command. 


@ Program Execution Environment 


Another set of interfaces is embodied in the implementation 
environment seen by PL/I programmers. This environment 
consists of a directly addressable virtual memory containing 
the entire hierarchy of online information, a dynamic linking 
facility which searches this hierarchy to bind procedure ref- 
erences, a device-independent input/output [16] system 
(the Michigan Terminal System [17] has a similar device- 
independent input/output system) and program debugging 
and metering facilities. These facilities enjoy a symbiotic 
relationship with the PL/I procedure environment used both 
to implement them and to implement user facilities Co-exist- 
ing with them. Of major significance is that the natural inter- 
nal environment provided and required by the system is 
exactly that environment expected by PL/! procedures. For 
example, PL/{ pointer variables, call and return statements, 
conditions, and static and automatic storage all correspond 
directly to mechanisms provided in the internal environ- 
ment. Consequently, the system supports PL/I code as a 
matter of course. 

The main effect of the combination of these features is to 
permit the implementer to spend his time concentrating on 
the logic of his problem; for the most part he is freed from 
the usual mechanical problems of storage management and 
overlays, input/output device quirks, and machine-depend- 
ent features. 


= Some Implementation Experience 


The Multics team began to be much more productive once 
the Multics system became useful for software development. 
A few cases are worth citing to illustrate the effectiveness of 
the implementation environment. A good example is the 
current PL/| compiler, which is the third one to be imple- 
mented for the project, and which consists of some 250 


procedures and about 125 K words of object code. Four 
people implemented this compiler in two years, from start to 
first general use. The first version of the Multics program 
debugging system, composed of over 3,000 lines of source 
code, was usable after one person spent some six months of 
nights and weekends ‘‘bootlegging’’ its implementation. As 
a last example, a facility consisting of 50 procedures with a 
total of nearly 4,000 PL/I statements permitting execution of 
Honeywell 635 programs under Multics became operational 
after one person spent eight months learning about the 
GCOS operating system for the 635 PL/I, and Multics, and 
then implemented the environment. In each of these exam- 
ples the implementation was accomplished from remote ter- 
minals using PL/I. 

Multics users have discovered that it is possible to get their 
programs running very quickly in this environment. They 
frequently prepare “rough drafts’ of programs, execute 
them, and then improve their overall design and operating 
Strategy using the results of experience obtained during ac- 
tual operation. As an example, again drawn from the imple- 
mentation of Multics, the early designs and implementations 
of the programs supporting the virtual memory [18] made 
over-optimistic use of variable-sized storage allocation tech- 
niques. The result was a functionally correct but inade- 
quately performing set of programs. Nevertheless, these 
modules were used as the foundation for subsequent work 
for many months. When they were finally replaced with 
modules using simplified fixed-size storage techniques, per- 
formance improvements of over an order of magnitude were 
realized, This technique emphasizes two points: first, it is 
frequently possible to provide a practical, usable facility con- 
taining temporary versions of programs; second, often the 
insight required to significantly improve the behavior of a 
program comes only after it is studied in operation. As im- 
plied in the earlier discussion of design iteration, our experi- 
ence has been that structural and strategic changes rather 
than ‘‘polishing’ (or recoding in assembly language) produce 
the most significant performance improvements. 

In general, we have noticed a significant ‘amplifier’ or 
‘leverage’ effect with the use of an effective online environ- 
ment as a system programming facility. Major implementa- 
tion projects on the Multics system seldom involve more 
than a few programmers, thereby easing the management 
and communications problems usually entailed by complex 
system implementations. As would be expected, the amplifi- 
cation effect is most apparent with the best project person- 
nel. 


Administration of. Multics 
Facilities and Resources 


The problem of managing the capabilities of a Computer 
ulility with geographically dispersed subscribers leads to a 
requirement of decentralized administration. At the apex of 
an administrative pyramid resides a system administrator 
with the ability to register new users, Confer resource quotas, 
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and generate periodic bills for services rendered. The system 
administrator deals with user groups called projects. Each 
group can in turn designate a project administrator who is 
delegated the authority to manage a budget of system re- 
sources on behalf of the project. The project administrator 
is then free to deal directly with project members without 
further intervention fram the system administrator, thereby 
greatly reducing the bottlenecks inherent in a completely 
centralized administrative structure. 


# Environment Shaping 


In addition to having immediate control of such resources as 
secondary storage, port access, and rate of processor usage, 
the project administrator is also able to define or shape the 
environment seen by the members of his project when they 
log into the system. He does this by defining those proce- 
dures that can be accessed by members of his project and 
by specifying the initial procedure executed by each mem- 
ber of his project when he logs in. This environment shaping 
facility has led to the notion of a private project subsystem 
on Multics. It combines the administrative and programming 
facilities of Multics so that a project administrator and a few 
project implementers can build, maintain, and evolve envi- 
ronments entirely on their own. Thus, some subsystems bear 
no internal resemblance to the standard Multics procedure 
environmeni. 

For example, the Dartmouth BASIC [19] compiler exe- 
cutes ina closed subsystem implemented by an M.1.T. stu- 
dent group for use by undergraduate students. The compiler, 
its object code, and all support routines execute in a simula- 
tion of the native environment provided at Dartmouth. The 
users of this subsystem need little, if any, knowledge of 
Multics and are able to behave as if logged into the Dart- 
mouth system proper. Other examples of controlled envi- 
ronment subsystems include one to permit many programs 
which normally run under the GCOS operating system to 
also run unmodified in Multics. Finally, an APL [20] subsys- 
tem allows the user to behave for the most part as if he were 
logged into an APL machine. The significance of these sub- 
systems is that their implementers did not need to interact 
with the system administrator or to modify already existing 
Multics capabilities. The administrative facilities permit each 
such subsystem to be offered by its supporters as a private 
service with its own group of users, each effectively having 
its Own private Computer system. 


Other Multics Users 


Finally, we observe that the roles of the application user, the 
system operators and the hardware maintainers as seen by 
the system are simply those of ordinary Multics users with 
specialized access to the online procedures and data. The 
effect of this uniformity of treatment is to reduce greatly the 
maintenance burden of the system control software, One 
example, of great practical importance, has been the ease 
with which system performance measurement tools have 
been prepared for use by the operating staff. 
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INSIGHTS 


So far, we have discussed the status and appearance of the 
Multics system. A further question is what has been learned 
in the construction of Multics which is of use to the designers 
of other systems. Having a bright idea which cleazly solves 
a problem is not sufficient cause to claim a contribution if the 
idea is to be part of a complex system. In order to establish 
the real feasibility of an idea, all of its implications and conse- 
quences must be followed out. Much of the work on Multics 
since 1965 has involved following out implications and con- 
sequences of the many ideas then proposed for the proto- 
type computer utility. That following out is an essential part 
of proof of ideas is attested by the difficulties which have 
been encountered in other engineering efforts such as the 
development of nuclear fusion power plants and the electric 
automobile. Not all proposals work out; for example, ex- 
tended attempts to engineer an atomic powered airplane 
suggest infeasibility. 

Perhaps Multics’ most significant single contribution to the 
state of the art of computer system construction is the dem- 
onstration of a large set of fully implemented ideas in a 
working system. Further, most of these ideas have been 
integrated without straining the overall design; most addi- 
tional proposals would not topple the structure. Ideas such 
as virtual memory access to online storage, parallel process 
organization, routine but controlled information sharing, dy- 
namic linking of procedures, and high-level language imple- 
mentation have proven remarkably compatible and 
complementary. 

To illustrate some of the areas of progress in understanding 
of system organization and construction which have been 
achieved in Multics, we consider here the following five 
topics: 


Modular division of responsibility 

Dynamic reconfiguration 

Automatically managed multilevel memory ° 
Protection of programs and data 

System programming language 


Modular Division of Responsibility 


Early in the design of Multics a decision had to be made 
whether or not to treat the segmented virtual memory as a 
separately usable ‘‘feature’’, independent of a traditionally 
organized read/write type file system. The alternative, to use 
the segmented virtual memory as the file system itself, pro- 
viding the illusion of direct “in-core’’ access to all online 
storage, was certainly the less conservative approach (Fig. 
1). The second approach, which was the one chosen, led to 
a strong test of the ability of a computing system to support 
an apparent one-level memory for an arbitrarily large infor- 
mation base. It is interesting that the resulting almost total 
decoupling between physical storage allocation and data 
movement on the one hand and directory structure, naming, 
and file organization on the other led to a remarkably simple 
and functionally modular structure for that part of the system 
{18] (Fig. 2). 
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directory 
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Figure 1. The entire storage hierarchy may be mapped into individual user 
process address spaces (see arrows) as if contained in a primary memory. 
Ilusteated are the sharing of a supervisor segment by two users and private 
access to segments a and b. The necessary primary storage is simulated by 
a demand paging technique which moves information between the real 
primary. memory and secondary storage. 


General | 

user | 

interface | Zz 

Directory User I/O device 
| address space control and 
| management buffering 
—|— | 

Virtual | 

memory / | / 

multiprocess 

interface 


Processor multi- 
plexing and process 
synchronization 


{Drum, disk, core 


demand paging 
controller 


Figure 2. Major fines of modular divisian in Multics. Solid lines indicate 
calls for services. Dotted lines indicate implicit use of the virtual memory. 


Another area of Multics in which a high degree of func- 
tional modularity was achieved was in scheduling, multipro- 
gramming, and processor management. Because harnessing 
of multiple processors was an objective from the beginning, 
a careful and methodical approach to multiplexing pro- 
cessors, handling interrupts, and providing interprocess syn- 
chronizing primitives was developed. The resulting design, 
known as the Multics traffic controller, absorbed into a sin- 
gle, simple module a set of responsibilities often diffused 
among a scheduling algorithm, the input/output controlling 
system, the online file management system, and special pur- 
pose inter-user communication mechanisms [21]. 

Finally, with processor management. and online storage 
management uncoupled into well-isolated modules, the 
Multics input/output system was left with the similarly isola- 
table function of managing streams of data flowing from and 
to source and sink type devices [16]. Thus, this section of the 
system concentrates only on switching of the streams, allo- 
cation of data buffering areas, and device control strategies. 

Each of the divisions of labor described above represents 
an interesting result primarily because it is so difficult to 
discover appropriate divisions of complex systems. (See 
Dijkstra [22] for a further discussion of this point). Establish- 
ing that a certain proposed division results in simplicity, 
creates an uncluttered interface, and does not interfere with 
performance, is generally cause for a minor celebration. 


Dynamic Reconfiguration 


If the computer utility is ever to become as much a reality. 
as the electric power utility or the telephone communication 
service, its continued operation must not be dependent upon 
any single physical component, since individual components 
will eventually require maintenance. This observation leads 
an electric power utility to provide procedures whereby an 
idle generator may be dynamically added to the utility’s 
generating capacity, while another is removed for mainte. 
nance, all without any disruption of service to customers. A 
similar scenario has long been proposed for multiprocessor, 
multimemory computer systems, in which one would 
dynamically switch processors and memory boxes in and 
out of the operating configuration as needed. Unfortunately, 
though there have been demonstrated a few “special pur- 
pose”’ designs (an outstanding example is the American Air- 
lines SABRE system [23]) it has not been apparent how to 
provide for such operations in a general purpose system. A 
recent thesis [24] proposed a general model for the dynamic 
binding and unbinding of computation and memory struc- 
tures to and from ongoing computations. Using this model 
as a basis, the thesis also proposed a specific implementation 
for a typical multiprocessor, multimemory computing sys- 
tem. One of the results of this work was the addition to the 
operating Multics system of the capability of dynamically 
adding and removing central processors and memory 
modules as in Figure 3. The usefulness of the idea may be 
gauged by observing that at M.L.T. five to ten such reconfigu- 
rations are performed in a typical 24-hour operating day. 
Most of the reconfigurations are used to provide a secondary 
system for Multics development. 
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Figure 3.) Dynamic reconfiguration permits switching among the three 
typical operating configurations shown here, without currently logged-in 
users being aware that a change has taken place. 


Automatically Managed Multilevel Memory 


By now it has become accepted lore in the computer system 
field that the use of automatic management algorithms for 
memory systems constructed of several levels with different 
access times can provide a significant reduction of user pro- 
gramming effort. Examples of such automatic Management 
strategies include the buffer memories of the IBM system 
370 models 155, 165, and 195 |25] and the demand paging 
Virtual Memories of Multics, IBMs CP-67 [26] and the Michi- 
gan Terminal System [17]. Unfortunately, behind the mask 
of acceptance hides a worrisome lack of knowledge about 
how to engineer a multilevel memory system with appropri- 
ate strategy algorithms which are matched to the load and 
hardware characteristics. One of the goals of the Mulltics 
project has been to instrument and experiment with the 
Multilevel memory system of Multics, in order to learn better 
how to predict in advance the performance of proposed 
new automatically managed multiievel memory systems. 
Several specific aspects of this goal have been explored: 
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A strategy to treat core memory, drum, and disk as a 
three-level system has been proposed, including a ‘‘least- 
recently-used’’ algorithm for moving information from 
drum to disk. Such an algorithm has been used for some 
time to determine which pages should be removed from 
core memory [27]. The dynamics of interaction among 
two such algorithms operating at different levels are 
weakly understood, and some experimental work should 
provide much insight. The proposed strategy will be im- 
plemented, and then compared with the simpler present 
strategy which never moves things from drum to disk, 
but instead makes educated ‘‘guesses’’ as to which de- 
vice is most appropriate for the permanent residence of 
a given page. If the automatic algorithm is at least as good 
as the older, static one, it would represent an improve- 
ment in overall design by itself, since it would automati- 
cally track changes in user behavior, while the static 
algorithm requires attention to the validity of its guesses. 


@ A scheme to permit experimentation with predictive 
paging algorithms was devised. The scheme provides for 
each process a list of pages to be preloaded whenever 
the process is run, and a second list to be immediately 
purged whenever the process stops. The updating of 
these lists is controlled by a decision table exercised 
every time the process stops running. As every page of 
the Multics virtual memory is potentially shared, the de- 
cision table represents a set of heuristics designed to 
separate out those which are probably not being shared 
at the moment. 


@ A series of measurements was made to establish the 
effectiveness of a small hardware associative memory 
used to hold recently accessed page descriptors. These 
measurements established a profile of hit ratio (proba- 
blity of finding a page descriptor in the associative mem- 
ory) versus associative memory size which should be 
useful to the designer of virtual memory systems [28]. 


@ A set of models, both analytic and simulation, was con- 
structed to try to understand program behavior in a vir- 
tual memory. So far, two results have Deen obtained. 
One is the finding that a single program characteristic 
(the mean execution time before encountering a ‘‘miss- 
ing’ page in the virutal memory as a function of memory 
size) suffices to provide a quite accurate prediction of 
paging and idle overhead times. The second is a direct 
calculation of the distribution of response times under 
multiprogramming. Having available the entire response 
time distribution, rather than just averages, permits esti- 
mation of the variance and 90-percentile points of the 
distribution, which may be more meaningful than just the 
average. A doctoral thesis is in progress on this topic. 


Although the immediate effect of each of these investiga- 
tions is to improve the understanding or performance of the 
current version of Multics, the long-range payoff in method. 
cal engineering using better understood memory structures 
is also evident. 


Protection of Programs and Data 


A long-standing objective of the public computer utility has 
been to provide facilities for the protection of executing 
programs from one another, so that users may with confi- 
dence place appropriate control on the release of their pri- 
vate information. In 1967, a mechanism was proposed [29] 
and implemented in software which generalized the usual 
supervisor-user protection relationship. This mechanism, 
named ‘‘rings of protection’, provides user-written subsys- 
tems with the same protection from other users that the 
supervisor has, yet does not require that the user-written 
subsystem be incorporated into the supervisor. Recently, 
this approach was brought under intense review, with two 
results: 


® A hardware architecture which implements the 
mechanism was proposed [30]. One of the chief fea- 
tures of the proposed architecture is that subroutine 
calls from one protection ring to another use exactly 
the same mechanisms as do subroutine calls among 
procedures within a protection area. The proposal 
appears sufficiently promising that it is included in the 
specifications for the next generation of hardware to 
be used for Multics. 


m@ As an experiment in the feasibility of a multilayered 
supervisor, several supervisor procedures which re- 
quired protection, but not all supervisor privileges, 
were moved into a ring of protection intermediate 
between the users and the main supervisor. The suc- 
cess of this experiment established that such layering 
is a practical way to reduce the quantity of supervisor 
code which must be given all privileges. 


Both of these results are viewed as steps toward first, a more 
complete exploitation and understanding of rings of protec- 
tion, and later, a less constrained organization of the type 


suggested by Evans and LeClerc [31] and by Lampson [32].. 


But more importantly, rings of protection appear applicable 
to any Computer system using a segmented virtual memory. 
Two doctoral theses are underway in this area. 


System Programming Language 


Another technique of system engineering methodology be- 
ing explored within the Multics project is that of higher level 
programming language for system implementation. The ini- 
tial step in this direction (which proved to be a very big step) 
was the choice of the PL/I language for the implementation 
of Multics. By now, Multics offers an extensive case study 
in the viability of this strategy. Not only has the cost of using 
a higher level language been acceptable, but increased main- 
tainability of the software has permitted more rapid evolu- 
tion of the system in response to development ideas as well 
as user needs. Three specific aspects of this experience have 
now been completed: 


B The transition from an early PL/I subset compiler [14] 
to a newer compiler which handles almost the entire 
language was completed. This transition was carried 
out with performance improvement in practically ev- 
ery module converted in spite of the larger language 
involved. The significance of the transition is the 
demonstration that it is not necessary to narrow one’s 
sights to a “’simple’’ subset language for system pro- 
gramming. If the language is thoroughly understood, 
even a language as complex as the full PL/I can be 
effectively used. As a result, the same language and 
compiler provided for users can also be used for 
system implementation, thereby minimizing mainte- 
nance, confusion, and specialization. 


® Notwithstanding the observation just made, the time 
required to implement a full PL/I compiler is still too 
great for many situations in which the compiler im- 
plementation cannot be started far enough in ad- 
vance of system coding. For this reason, there is 
considerable interest in defining a smaller language 
which is easily compilable, yet retains the features 
most important for system implementation. On the 
basis of the experience of programming Multics ina 
subset of PL/I, such a language was defined but not 
implemented, since it was not needed [33]. 


@ A census of Multics system modules reveals how 
much of the system was actually coded in PL/I, and 
reasons for use of other languages. Roughly, of the 
1500 system modules, about 250 were written in 
machine language. Most of the machine language 
modules represent data bases or small subroutines 
which execute a single privileged instruction. (No at- 
tempt was made to provide either a data base com- 
piler or PL/I built-in’ functions for specialized 
hardware needs.) Significantly, only a half dozen 
areas (primarily in the traffic controller, the central 
page fault path, and interrupt handlers) which were 
originally written in PL/I have been recoded in ma- 
chine language for reasons of squeezing out the ut- 
most in performance. Several programs, originally in 
machine language, have been recoded in PI /I to in- 
crease their maintainability. 


As with the earlier topics, the implications of this work with 
PL/I should be felt far beyond the Multics system. Most 
implementers, when faced with the economic uncertainties 
of a higher-level language, have chosen machine language 
for their central operating systems. The experience of using 
PL/t for Multics, when added io ithe expanding collection ot 
experience elsewhere [34], should help reduce the uncer- 
tainty. 

In a research project as large, long, and complex as Mul- 
tics, any paper such as this must necessarily omit: many 
equally significant ideas, and touch only a few which may 
happen to have wide Current interest. His the purpase ot 
individual and detailed techarcal papers to explain these aad 
other ideas more fully. The bibliography found in reference 
[35] contains over twenty such technical papers. 
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IMMEDIATE FUTURE PLANS 


The Multics software is continuing to evolve in response to 
user needs and improved understanding of its organization. 
In 1972 a new hardware base for Multics will be installed by 
the Information Processing Center at M.I.T. for use by the 
M.I.T. computing community. This program compatible 
hardware base contains small but significant architectural 
extensions to the current hardware. The circuit technology 
used will be that of the Honeywell 6080 computer. The 
substantial changes include: 


® Replacement of the paging drum initially with bulk 
core and, when available, LSI memory. 


@ Implementation of rings of protection as part of the 
paging and segmentation hardware. 


Wherever possible the strategy of using off-the-shelf stan- 
dard equipment rather than specially engineered units for 
Multics has been followed. This strategy is intended to sim- 
plify maintenance. 


CONCLUSIONS 


ats are ip etany: conclusions nich could mposeiely be drawn 
consider four to be major and ane of note: First, we eieal 
it is clear that it is possible to achieve the goals of a prototype 
computer utility. The current implementation of Multics pro- 
vides a measure of the mechanisms required. Moreover, the 
specific implementation of the system, because it has been 
written in PL/I, forms a model for other system designers to 
draw upon when constructing similar systems. 

Second, the question of whether or not the specific soft- 
ware features and mechanisms which were postulated for 
effective computer utility operation are desirable has now 
been tested with specific user experience. Although the spe- 
cific mechanisms implemented subsequently may be super- 
seded by better ones, it is certainly clear that the 
improvement of the user environment which was wanted 
has been achieved. 

Third, systems of the computer utility class must evolve 
indefinitely since the cost of starting over is usually prohibi- 
tive and the many-year lead time required may be equally 
unacceptable. The requirement of evolvability places strin- 
gent demands on design, maintainability, and implementa- 
tion techniques. 

Fourth and finally, the very act of creating a system which 
solves many of the problems posed in 1965 has opened up 
many new directions of research and development. It would 
appear almost a certainty that increased user aspirations will 
continue to require intensive work in the areas of computer 
system principles and techniques. 

in closing, perhaps we should take note that in the seven 
years since Multics was proposed, a great many other sys- 
tems have also been proposed and constructed; many of 
these have developed similar ideas. Some examples which 
have not already been mentioned include: 
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the TENEX system of Bolt, Beranek and Newman 
the VENUS system of Mitre Corp. 

the MU5 at Manchester University 

RC-4000 of Regnecentralen 

5020 TSS of Hitachi Corp. 

DIPS-1 of Nippon Telephone 

the Japanese National Computer Project 

the PDP-10/50 TSS of Digital Equipment Corp. 
the CBB-500 of Berkeley Computer Corp. 

I.T.S. of the M.LT. Artificial Intelligence Laboratory 
Exec-8 of Univac 

System 3 and 7 and the SPECTRA .70/46 of RCA 
Star-100 of CDC 

UTS of Xerox Data Systems 

the 6700 system of Burroughs 

the Dartmouth Timesharing System 


In most cases, their designers have developed effective im- 
plementations which are directed to a different interpreta- 
tion of the goals, or to a smaller set of goals than those 
required for the complete computer utility. This diversity is 
valuable, and probably necessary, to accomplish a thorough 


~ exploration of many individually complex ideas, and thereby 


to meet a future which holds increasing demand for systems 
which embrace the totality of computer utility requirements. 


It is impossible to acknowledge accurately the contributions 
of all the individuals or even the several organizations which 
have given various forms of support to the development of 
Multics over the past seven years. As would be expected ot 
any multiorganization project spanning several years, there 
has been a turnover in the personnel involved. As the indi- 
vidual contributors now number in the hundreds, proper 
recognition cannot be given here. Instead, since the devel- 
opment of significant features and designs of Multics has 
occurred in specific areas and disciplines such as input/out- 
put, virtual memory design, languages, and resource mullti- 
plexing, a more accurate delineation of achievements should 
be made in specialized papers. So in the end we must defer 
to the authors of individual papers, past and future, to ac- 
knowledge the efforts of some of the many contributors who 
have made the evolution of Multics possible. 


APPENDIX: A CHECKLIST OF 
MULTICS FEATURES 


Following is a checklist of currently available features and 
facilities of Multics. Although aiany of the features are de 
scribed in cryptic and untranslated local jargon, one Can al 
least obtain a feel for the range of facilities now provided. 
Further information on most of these features may be found 
in the Multics Programmers’ Manual [35]. 


CHECKLIST OF MULTICS FEATURES 


Interactive Time-Sharing Facilities 


file editors 

file manipulation (rename/move/delete) 
personal command abbreviations 

recursive command language 

source language debugging with breakpoints 
subroutine call tracer 

can stop any running command or program 


Programming Languages 


PL/I 
FORTRAN 
BASIC (The BASIC system and the Dartmouth envi- 
ronment were developed at Dartmouth College. 
Used at M.1.T. by permission of Dartmouth College.) 
APL 

LISP 

BCPL 

ALM (assembly language /Multics) 


1’ 


Information Storage System 


configuration independent 

accessed through virtual memory (segments) 
access control lists by user and project 

links to segments of other users 

hierarchical directory (catalog) arrangements 
public library facilities 

sharing at all levels 

multiple segment names (synonyms) 
separate control of read, write, and execute 


Programming Environment 


segmented virtual memory 

dynamic linking of procedures and data, or prelinking 
interprocess Communication 

independent of configuration 

uniform error handling mechanism 

user definable protection rings 

microsecond calendar clock with interrupt 

program interrupt signal from console 


Input and Output 


standard typewriter interface for device indepen- 
dence 

ASCII character set used throughout 

input characters converted to canonical form 

erase and kill editing on typed input 

1/Q streams switchable during execution 

Magnetic tape, printer, card punch, card reader 
typewriter terminals (IBM 2741, 1050; Teletype 37, 
33, 35; Dura; Datel; Execuport; Terminet-300) 
graphic support library (devices: ARDS, IMLAC, DEC 
338) 

ARPA network 

interfaces at three levels (formatted data Coversion; 
bit stream control; full device control) 


Management Facilities 


passwords required for login 

project may interpose authentication procedure 
decentralized projects 
accounting, billing, and quotas 

online probing and account adjustment 

operator or system initiated logout of users 

unlisted and anonymous users 

limited service system 

dynamic reconfiguration of memories and processors 
system performance metering for parameter adjust- 
ment 

project-imposed starting procedure 


Communication Facilities 


interuser mail 

help command, help files 

message of the day 

online error reporting and consultation service 
online user graffiti board 

operations message broadcast to logged-in users 


Absentee Facilities 


priority/defer queues for printer, card punch 
queued translator facility 
general absentee job facility 


Reliability Measures 


weekly file copies onto tape 

daily disk/drum copy onto tape 

incremental file copies onto tape, 1/2 hour behind 
use wen 

salvager to clean up files after system crash 
emergency shutdown entry to system 


Maintenance Features 


Private Project Subsystems 


online library change, no disruption of current users 
entire system source online, maintenance tools 
system checkout on small hardware configuration 
online performance monitoring of multiprogramming 
(paging traffic; drum/disk usage; typewriter traffic) 
user performance feedback (cpu time and paging 
load on each command; page trace always operating; 
subroutine call counters) 


project-providable command interface 

Dartmouth environment (The BASIC system and the 
Dartmouth environment were developed at Dart- 
mouth College. Used at M.I.T. by permission) 
student environment 


Miscellaneous Facilities 


C-11 


desk calculators 

sort Command 

memorandum formatting and typing subsystem 
user-provided list of programs to be automatically 
executed when user logs in 

GCOS environment 
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MULTICS SYSTEM 


This is the information that a new Multics programmer 
receives when he becomes a user at M.I.T. (or else- 
where). This should be of interest in view of impending 
upgrading of the system. 

The next issue of the Honeywell Computer Journal 
will carry a special microfiche devoted to a historical 
potpourri of the major papers on Multics. 
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Introduction 


Multics (from Multiplexed Information and Computing 
Service) is the name of a new, general-purpose computer 
system developed by the Computer System Research group 
at M.1.T. Project MAC, in cooperation with Honeywell Infor- 
mation Systems (formerly the General Electric Company 
Computer Department) and the Bell Telephone Laborato- 
ries. This system is designed to be a ‘computer utility”, 
extending the basic concepts and philosophy of the Compat- 
ible Timesharing System (CTSS, operating now on the IBM 
7094 computer) in many directions. Multics is implemented 
initially on the Honeywell 645 computer system, an en- 
hanced relative of the Honeywell 635 computer. 

One of the over-all design goals of Multics is to create a 
computing system which is capable of meeting almost all of 
the present and near future requirements of a large computer 
utility. Such systems must run continuously and reliably 7 
days a week, 24 hours a day, in a way similar to telephone 
or power systems, and must be’ capable of meeting wide 
service demands: from multiple man-machine interaction to 
the sequential processing of absentee user jobs; from the use 
of the system with dedicated languages and subsystems to 
the programming of the system itself; and from centralized 
bulk card, tape, and printer facilities to remotely located 
terminals. Such information processing-and communication 
systems are believed to be essential for the future growth of 
computer use in business, in industry, in government and in 
scientific laboratories, as well as stimulating applications 
which would otherwise be untried. 

Because the system must ultimately be comprehensive 
and able to adapt to unknown future requirements, its frame- 
work must be general, and capable of evolving with time. As 
brought out in the sequel, this need for an evolutionary 
framework influences and contributes to much of the system 
design and is a major reason why most of the programming 
of the system has been done in a subset of the PL/I language. 
Because the PL/I! language is largely machine-independent 
(e.g., data descriptions refer to logical items, not physical 
words), the system should also be. Specifically, it is hoped 
that future hardware improvements will not make system 
and user programs obsolete and that implementation of the 
entire system on other suitable computers will require only 
a moderate amount of additional programming. 

As computers have matured during the last two decades 
from curiosities to calculating machines to information pro- 
cessors, access to them by users has not improved, and, in 
the case of most large machines, has retrogressed. Princ 


pally for economic reasons, batch processing of computer 
jobs has been developed and is currently practiced by most 
large computer installations, and the concomitant isolation 
of the user from elementary cause-and-effect relationships 
has been either reluctantly endured or rationalized. For sev- 
eral years a solution has been proposed to the access prob- 
lem. This solution, usually called timesharing, is basically the 
rapid time-division multiplexing of a central processor unit 
among the jobs of several users, each online at a typewriter- 
like terminal. The rapid switching of the processor unit 
among user programs is, of course, nothing but a particular 
form of multiprogramming. 

The impetus for timesharing first arose from professional 
programmers because of their constant frustration in debug- 
ging programs at batch processing installations. Thus, the 
Ofiginal goal was tc timeshare computers to allow simulta- 
neous access by several persons while giving to each of them 
the illusion of having the whole machine at his disposal. This 
goal led to the development of the Compatible Timesharing 
System (CTSS) at M.I.T. Project MAC. However, at Project 
MAC it has turned out that simultaneous access to the ma- 
chine, while obviously necessary to the objective, has not 
been the major ensuing benefit. Rather, it is the availability 
at one’s fingertips of facilities for editing, compiling, debug- 
ging, and running programs in one continuous interactive 
session that has had the greatest effect on programming. 
Professional programmers are encouraged to be more imagi- 
native in their work and to investigate new programming 
iechniques and new problem approaches because of the 
much smaller penalty for failure. But, the most significant 
effect that CTSS has had on the M.1.T. community is seen in 
the achievements of persons for whom computers are tools 
for other objectives. The availability of CTSS not only has 
changed the way problems are attacked, but has caused 
important research to be undertaken that otherwise would 
not have been done. As a consequence, the objective of the 
current and future development of timesharing extends 
beyond the improvement of computational facilities with 
respect to traditional computer applications. Rather, it is the 
online use of computers for new purposes and in new fields 
which provides the challenge and the motivation to the sys- 
tem designer. In other words, the major goal is to provide 
suitable tools for what is currently being called machine- 
aided cognition. 

More specifically, the importance of a multiple-access 
system operated as a computer utility is that it allows a vast 
enlargement of the scope of computer-based activities, 
which can, in turn, stimulate a corresponding enrichment of 
many areas of our society. Over six years of experience 
indicates that continuous Operation in a utility-like manner, 
with flexible remote access, encourages users to view the 
system as a thinking tool in their daily intellectual work. 
Mechanistically, the qualitative change from the past results 
from the drastic improvement in access time and conve- 
nience. Objectively, the change lies in the user’s ability to 
control and affect interactively the course of a process 
whether it involves numerical computation or Manipulation 
of symbols. Thus, parameter studies are more intelligently 
guided; new problem-oriented languages and subsystems 
are developed to expioit the interactive capability; many 


complex analytical problems, as in magnetohydrodynamics, 
which have been too cumbersome to be tackled in the past, 
are now being successfully pursued; even more, new, imagi- 
native approaches to basic research have been developed, 
as in the decoding of protein structures. These are examples 
taken from an academic environment; the effect of multiple- 
access systems on business and industrial organizations can 
be equally dramatic. It is with such new applications in mind 
that the Multics system has been developed. Not that the 
traditional uses of computers are being disregarded: rather, 
these traditional needs are viewed as a subset of the broader, 
more demanding, new requirements. 

To meet the above objectives, issues such as response 
time, convenience of manipulating data and programs, ease 
of controlling processes during execution, and, above all, 
protection of private information and isolation of indepen- 
dent processes, become of critical importance. These issues 
demand departures from traditional Computer systems. 
While these departures are deemed to be desirable with 
respect to traditional computer applications, they are essen- 
tial for rapid man-machine interaction. 


System Requirements 


In the early days of computer design, there was the concept 
of a single program on which a single processor computed 
for long periods of time with almost no interaction with the 
outside world. 
The effective boundaries of an information processing sys- 
tem extend beyond the processor, beyond the card reader 
and printer, and even beyond the typing of input and the 
printing of output. In fact, they encompass the goals of many 
people. To better understand the effect of this broadened 
design scope, it is helpful to examine several phenomena 
characteristic of large, service-oriented computer installa- 
tions. 

First, there are incentives for any organization to have the 
biggest possible computer system that it can afford. It is 
usually only on the biggest computers that there are elabo- 
rate programming systems, compilers, and features which 
make a computer ‘powerful’. This results partly because tt 
is more difficult to prepare system programs for smaller com. 
puters when limited by speed or memory size, and partly 
because large systems involve more persons and, hence, 
permit more attention to be given to system programs. 
Moreover, by combining resources in a single Computer 
system rather than in several, bulk economies and therefore 
lower computing costs can be achieved. Finally, as a practi- 
cal matter, considerations of floor space, management effi- 
ciency, and operating personnel provide a strong incentive 
for centralizing computer facilities in a single large installa- 
tion. 

Second, the capacity of a contemporary Computer instal- 
lation, regardless of the sector of applications it serves, must 
be capable of growing to meet continuously increasing de- 
mand. A doubling of demand every two years is not uncom- 
mon, Multiple-access computers promise to accelerate this 
growth turther since they allow a man-machine interaction 
rate which ts faster by at least two orders of magnitude than 
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other types of computing systems. Present indications are 
that multiple-access systems for only a few hundred users 
can generate a demand for computation exceeding the ca- 
pacity of the fastest existing single processor system. Since 
the speed of light, the physical sizes of computer compo- 
nents, and the speeds of memories are intrinsic limitations on 
the speed of any single processor, it is clear that systems with 
multiple processors and multiple memory units are needed 
to provide greater capacity. This is not to say that fast pro- 
cessor units are undesirable, but that extreme system com- 
plexity to enhance this single parameter among many 
appears neither wise nor economic. 

Third, computers are no longer a luxury used when and 
if available, but are primary working tools in business, gov- 
ernment, and research laboratories. The more reliable com- 
puters become, the more their availability is depended upon. 
A system structure including pools of functionally identical 
units (processors, memory modules, input/output controll- 
ers, etc.) can provide continuous service without significant 
interruption for equipment maintenance, as well as provide 
growth capability through the addition of appropriate units. 

Fourth, user programs, especially in a timesharing system, 
interact frequently with secondary storage devices and ter- 
minals. This communication traffic produces a need for mul- 
tiprogramming to avoid wasting main processor time while 
an input/output request is being completed. It is important 
to note that an individual user is ordinarily not is a position 
to do an adequate job of multiprogramming since his pro- 
gram lacks proper balance, and he probably lacks the neces- 
sary dynamic information, ingenuity, or patience. 

Finally, as noted earlier, the value of a timesharing system 
lies not only in providing, in effect, a private computer to a 
number of people simultaneously, but, above all, in the ser- 
vices that the system places at the fingertips of the users. 
Moreover, the effectiveness of a system increases aS user- 
developed facilities are shared by other users. This increased 
effectiveness because of sharing is due not only to the re- 
duced demands for core and secondary memory, but also 
to the cross-fertilization of user ideas. Thus, a major goal of 
the present effort is to provide multiple access to a growing 
and potentially vast structure of shared data and shared 
program procedures. In fact, the achievement of multiple 
access to the computer processors should be viewed as but 
a necessary subgoal of this broader objective. Thus, the 
primary and secondary memories where programs reside 
play a central role in the hardware organization, and the 
presence of independent communication paths between 
memories, processors, and terminals is of critical impor- 
lance, 

From the above it can be seen that the system require- 
ments of a computer installation are not for a single program 
on a single computer, but rather for a large system of many 
components serving a community of users. Moreover, each 
user of the system asynchronously initiates jobs of arbitrary 
and indeterminate duration which subdivide into sequences 
of processor and input/output tasks. It is out of this seem- 
ingly chaotic, random environment that one arrives at a 
utility-like view of a computing system, For instead of Chaos, 
one can average over the different user requests to achieve 
high utilization of all resources. The task of multiprogram- 


80 HONEYWELL COMPUTER JOURNAL 


required to do this need only be organized once in a central 
supervisor program. Each user thus enjoys the benefit of 
efficiency without having to average the demands of his own 
particular program. 

With the above view of computer use, where tasks start 
and stop every few milliseconds, and where the memory 
requirements of tasks grow and shrink, it is apparent that one 
of the major jobs of the supervisor program (i.e., monitor, 
executive, etc.) is the allocation and scheduling of computer 
resources. The general strategy is clear. Each user’s job is 
subdivided into tasks, usually as the job proceeds, each of 
which is placed in an appropriate queue (i.e., for a processor 
or an input/output controlier). Processors or input/output 
controllers are, in turn, assigned new tasks as they either 
complete or are removed from old tasks. All processors are 
treated equivalently in an anonymous pool and are assigned 
to tasks as needed. In particular, the supervisor does not 
have a special processor. Further, processors can be added 
or deleted without significant change in either the user or 
system programs. Similarly, input/output controllers are di- 
rected from queues independently of any particular pro- 
cessor. Again, as with the processors, one can add or delete 
input/output capacity according to system load without sig- 
nificant reprogramming required. 


The Multics System 


The over-all design goal of the Multics system is to create a 
computing system which is capable of comprehensively 
meeting almost all of the present and near future require 
ments of a large computer service installation. It is not ex: 
pected that the initial system, although useful, will reach the 
objective; rather, the system will evolve with time in a pen- 
eral framework which permits continual growth to meet 
unknown future requirements. The use of the PL/I language 
will allow major system software changes to be developed 
ona schedule separate from that of hardware changes. Since 
most organizations can no longer afford to overlap old and 
new equipment during changes, and since software develop- 
ment is at best difficult to schedule, this relative machine- 
independence should be a major asset. 

It is expected that the Multics system will be published and 
will therefore be available for implementation on any equip- 
ment with suitable characteristics. Such publication is desir- 
able for two reasons: first, the system should withstand 
public scrutiny and criticism; second, in an age of increasing 
complexity, there is an obligation to present and future sys 
tem designers to make the inner operating system as lucid as 
possible so as to reveal the basic system issues. 

An ability to share data contained within the framework 
of a general-purpose timesharing system is a unique feature 
of Multics, and is directly applicable to administrative prob- 
lems, research requiring a multi-user accessible database, 
and general application of the computer to very complicated 
research problems. The attention paid to mechanisms to 
provide and control privacy is of direct interest for several 
of the same applications as well as, for example, medical 
data. Multics can thus be a valuable tool which provides 
opportunities for important new research in these areas. 


Ine Hardware System 


The Honeywell 645 computer system is a large-scale infor- 
mation processing system with most of the features currently 
found in such systems. If one attempted to classify systems, 
it would fall in the same general category of size as the 
Honeywell 635, the Univac 1108, and the IBM Systems 
360/65 and 67. 

The configuration at M.1.T., shown in Figure 1, currently 
contains 384 K (K = 1024) 36-bit words of core memory (1 
microsecond access to 36 bits or 1.3 microseconds access 


| 645 | 


Processor 


645 
Processor 


Core Core 


to 72 bits), two central processors (330,000 instructions per 
second when running Multics), a high-performance paging 
drum (it moves 1024 words in 2 milliseconds, 16 mil- 
liseconds average latency with a queue-driven channel con- 
troller), 78 million words of disk storage, and a Generalized 
1/O Controller which handles magnetic tapes, card equip- 
ment, and high-speed full ASCII printers, as well as all tele- 
communication channels. The central processor is built on 
the Honeywell 635 instruction set with augmentation to per- 
mit control of paging and segmentation hardware. 
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Overview of Multics Capabilities 


Multics offers a number of capabilities which go well beyond 
those provided by many other systems. Those which are 
most significant from the user’s point of view are described 
here. Perhaps the most interesting aspect of all is that a single 
system encompasses all of these capabilities simultaneously. 
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The ability to be a small user of Mulltics. 


An underlying consideration throughout the Multics de- 
sign has been that the simple user should not pay a 
noticeable extra price for a system which also accommo- 
dates the sophisticated user. For example, a student can 
be handed a limited set of tools, can do limited work 
(perhaps debugging and running small FORTRAN pro- 
grams), and expect to receive a bill for resource usage 
which is equivalent to the limited work done. If all users 
are small, then of course the number of users can be 
increased in proportion to their smallness. As an adminis- 
trative aid, facilities are provided so that one can restrict 
any particular user to a specific set of tools and thereby 
limit his ability to use up resources. 


The ability to control sharing of information. 


There are a variety of applications for a computer system 
which involve building up a base of information which 
is to be shared among several individuals. Multics pro- 
vides facilities in two directions. 


Sharing: 
Links to other users’ programs and data. F 


Ability to move one’s base of operation into another user’s 
directory (with his permission). 


Direct access with uniform conventions to any information 
stored in the system. 


Ability for two or more users to share a single Copy of a 
program or data in core memory. 


Control: 


Ability to specify precisely to whom, and with what access 
mode (e.g., read, write, and execute permissions are sepa- 
rate and per-user) a piece of data or the entire contents of 
a subdirectory are available. 


Ability to revoke access at any time. 


Ability, using the Multics protection ring structure, to force 
access to a database to be only via a program supplied by 
the database owner, This facility may be used to allow 
access to aggregate information, such as averages or Counts, 
or specified data entries, without simultaneously giving ac- 
cess to the entire file of raw data, which may be confiden- 
tal There are a large number of potential adoiinistrative 
applications of this feature, and as far as is known, Multics 
is the only general-purpose system which provides it. 
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In the opposite direction of the little user is the person 
with a difficult research problem requiring a very large 
addressable memory. The Multics storage system, with 
the aid of a high-performance paging drum, provides this 
facility in what is often called a virtual memory of an 
extent limited only by the total of secondary storage 
devices (drums, disks, etc.) attached to the system. An 
interesting property of the Multics implementation is that 
a procedure may be written to operate in a very large 
virtual memory, but core resources are used only for 
those parts of the virtual memory actually touched by the 
program on that execution, and disk and drum resources 
are used only for those parts of the memory which actu- 
ally contain data. Another very useful property from a 
programmer’s point of view is that information stored in 
the storage system is directly accessible to his program 
by a virtual memory address. This property eliminates 
the need for explicitly programmed overlays, Chain links, 
or core loads, and also reduces the number of explicitly 
programmed input and output operations. The Multics 
storage system takes on the responsibility for safekeeping 
of all information placed there by the user. It therelore 
automatically maintains tape copies of all information 
which has remained in the system for more than an hour. 
These tapes can be used to reload any‘user information 
lost or damaged as a result of hardware or software 
failures, and may also be used to retrieve individual items 
damaged by a user’s own blunder. 

Each user has an administratively set quota of space 
which limits the amount of storage he can use, although 
he may purchase as large an amount of space as he 
would like. Additional disk storage can be added to the 
645 computer in large quantities if necessary. 


The option of dynamic linking. 


In constructing a program or system of programy, Was 
frequently convenient to begin testing Certain features of 
one program: before having written another program 
which is needed for some cases. Dynamic linking allows 
the execution of the first program to begin, and a search 
for the second program is undertaken only if and when 
it is actually called by the first one. This feature also 
allows a user to freely include in his program a condi- 
tional call out to a large and sophisticated error diagnos- 
tic program, secure in the knowledge that in all those 
executions of his program which do not encounter the 
error, he will not pay the cost of locating, linking, and 
mapping the error diagnosis package into his virtual 
memory. It also allows a user who is borrowing a pro- 
gram to provide a substitute for any subroutine called by 
that program when he uses it, since he has control over 
where the system looks to find missing subroutines. la 
those cases where subroutine A calls subroutine B every 
time, there is, of course, no need to use dynamic linking 
(and the intplied library search), and so facilities are 
therefore provided to bind A and B together prior to 
execution. 


B Configuration Flexibility. 


An important aspect of the Multics design is that it is 
actually difficult for a user to write a program which will 
stop working correctly if the hardware configuration is 
changed. In response to changing system-wide needs, 
the amount of core memory, the number of central pro- 
cessors, the amount and nature of secondary storage 
(disks, drums, etc.), and the type of interactive typewriter 
terminals may change with time over a range of 2 or 3 
to 1, but users do not normally need to change their 
programs to keep up with the hardware. The system itself 
adapts to changes in the number of processor or memory 
boxes dynamically, that is, while users are logged in. 
Most other configuration changes (e.g., the addition of 
disk storage units) require that the systern be reinitialized, 
an operation which takes a few minutes. 


@ The human interface. 


Experience has proven that ease of use of a timesharing 
system is considerably more sensitive to human engi- 
neering than is a batch processing system. The Multics 
command language has been designed with this in mind. 
Features such as universal use of a character set with 
both upper and lower case letters in it, and allowing 
names of files to be 32 characters long, are examples of 
the little things which allow the nonspecialist to feel that 
he does not have to discover a secret in order to be an 
effective user of the system. In a similar vein, a hierar- 
chial file system provides a very useful organization and 
bookkeeping aid, so that a user need keep immediately 
at hand only those things he is working with at the mo- 
ment. Such a facility is of great assistance when attacking 
complicated or intricately structured problems. 


Languages 


Multics provides two primary user languages: FORTRAN IV 
and PL/I. The FORTRAN compiler is fairly standard. !t is 
supported by the usual library of math routines and format- 
ted input/output facilities. Its primary use is for translation of 
already written programs which have been imported from 
_ other computer systems. 

The Multics PL/! compiler is quite interesting because it 
offers a very full selection of language facilities, over 300 
helpful error diagnostics, and the ability to get at the ad- 
vanced features of Multics, all at a reasonable cost. On a 
“seconds to translate a source language page’ basis, the 
PL/I compiler currently takes about twice as long as does the 
FORTRAN compiler; on the other hand, a page of PL/I 
program can express considerably more than a page of FOR- 
TRAN program. For these reasons, as well as the anticipated 
wide availability of PL/!on other computer systems, it is the 
recommended language for subsystem implementers and 
general research users needing an expressive language, 

Other languages are: 


BASIC A translator and editor subsystem for the BASIC 
language, developed at Dartmouth College. A lirn- 
ited Multics service is available which restricts the 
uset to just this subsystem, if desired. The BASIC 
subsystem is also available to regular Multics users. 


APL A powerful and popular interpretive language devel- 
oped by Kenneth Iverson. 


LISP _—_List Processing language, version 1.5. Both an inter- 
preter and a compiler for this popular language for 
“artificial intelligence’’ problems are available. An 
interesting feature of the Multics implementation is 
the very large structure space provided by the vir- 
tual memory. 


ALM — A machine language assembler for the Honeywell 
645 computer. (It is not recommended for general 
use; it is slow and the language is very difficult.) 


QEDX A programmable editor which qualifies as a minor 
interpretive language. 


All of the above languages translate a source program which 
has been previously placed in the storage system. Input and 
editing of source text is done with one of the available text 
editors, EDM or QEDX. Although interactive, line-by-line 
syntax checking languages are easily implemented in the 
Multics environment, none are yet available. 

A source language debugging system, named DEBUG, 
provides the ability to inspect variables and set breakpoints 
in terms of the PL/! program being debugged. It also has a 
variety of features to allow inspection of all aspects of the 
Multics execution environment. 


Reliability and Performance 


An initial version of Multics began operating on a scheduled 
daily basis for system programming use in 1968 September. 
It has been scheduled to run on a 24-hour-a-day basis since 
1969 May 1. Since that time, almost three years of opera: 
tional experience has been obtained. During this time, cel. 
ability, functional capabilities, and performance have been 
brought to the point that, as of 1972 January 1, a two pro- 
cessor system serves 55 simultaneous users, with good in- 
teractive response. 

The full configuration of Figure 1 is used regularly, and 
should ultimately handle about 90 average PL/I program- 
mers. Both smaller and larger users are also runnable on the 
system, in increased and reduced numbers, respectively. 

As an offering of the M.1.T. Information Processing Center, 
Multics has attracted a community of about 600 registered 
users, and an equal number of unregistered student users. 
These users are organized around approximately 100 
projects, thus making Multics the primary source of time- 
sharing services at M.I.T. (As with all LP.C. computer sys- 
tems, the use of Multics is charged to its users at nates 
adjusted to return full hardware and cunning costs when the 


_ svstem is eperating at about two-thirds capacity.) 
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A MULTICS BIBLIOGRAPHY 


Manuals that are Generally Available 


1. 


6. 


Multics Programmers’ Manual. An updateable refer- 
ence manual giving calling sequences and reference 
information for all user-callable subroutines and com- 
mands. Includes an introduction to the Multics pro- 
gramming environment and a guide to typical ways of 
using the system. Approximately 800 pages. 


The Multics System: An Examination of Its Structure, 
by E. 1. Organick. A hard cover book describing in some 
detail how Multics works. The description is from the 
point of view of a programmer developing a large pro- 
gram or subsystem, who wishes to gain the extra insight 
to help him intelligently choose among available alter- 


natives of his implementation. M.1.T. Press, Cambridge, 


MA, and London, England. 392 pp. (1972). 


A User's Guide to the Multics FORTRAN Implementa- 
tion, by R.A. Freiburghouse. A document which pro- 
vides the prospective Multics FORTRAN user with 
sufficient information to enable him to create and exe- 
cute FORTRAN programs on Multics. It contains a com- 
plete definition of the Multics FORTRAN language as 
well as a description of the FORTRAN command and 


Manuals that may be examined in the 
Project MAC or I. P. C. Document Rooms 


us 


error messages. It also describes how to communicate ~ 


with non-FORTRAN programs, and discusses some of 
the fundamental characteristics of Multics which affect 
the FORTRAN user. 68 pages. 


Multics PL// Language Specification. A reference man- 
ual which specifies precisely the subset of the PL/I lan- 
guage used on Multics. 174 pages. 


User’s Guide to the Multics PL/l Implementation, by 
R.A Freiburghouse, et al. Provides detailed information 
about how the PL/I language is embedded in the Mul- 
tics programming environment. 53 pages. 


Graphic Users’ Supplement to the Multics Program- 
mers” Manual. In the same format as the Multics Pro- 
grammers’ Manual, this supplement gathers in one 
place descriptions of the Multics Graphics System and 
the commands and subroutines needed to use it, Ap- 
proximately 55 pages, illustrated. 
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Multics System Programmers’ Manual. In principle, a 
complete reference manual describing how the system 
works inside. In fact, this document contains many sec- 
tions which are inconsistent, inaccurate, or obsolete; it 
is in need of much upgrading. However, its overview 
sections are generally accurate and valuable if insight 
into the internal organization is desired. Approximately 
3,500 pages. 


System Programmers’ Supplement to the Multics Pro- 
grammers‘ Manual. This updateable reference manual, 
in the same format as the Multics Programmers’ Man- 
ual, provides calling sequences of every system 
module. Approximately 850 pages. 


EPLBSA Programmer’s Reference Handbook, by. 
D.}.Riesenberg. A manual describing the assembly (ma- 
chine) language for the Honeywell 645 computer. The 
language has been renamed ALM since the publication 
of this manual. (Needed only by programmers with 
some special reason to use 645 machine language.) 85 
pages. 


Honeywell 645 Processor Manual. A hardware de- 
scription, including opcodes, addressing modifiers, etc. 
Of interest only to dedicated machine language pro- 
grammers. 175 pages. 


Subsystem Writers’ Supplement to the Multics Pro- 
grammers’ Manual. A manual giving calling sequences 
of internal interfaces of the system which are user- 
accessible. For the sophisticated subsystem writer who 
feels that ii is important to bypass some standard Mul- 
tics facility, this manual provides some help in using 
interfaces one level deeper into the system. This manual 
is definitely not for the casual user. Approximately 50 
pages. 


Technical Papers about Multics 


1. 


10. 


WW. 


16. 


F.J.Corbat6é and V.A.Vyssotsky, “Introduction and Overview 
of the Multics System’, AF/PS Conf. Proc., Fall Joint Comput. 
Conf. 27, Spartan Books, Washington, DC, 1965, pp. 185- 
196. 


E.L.Glaser, et al., “System Design of a Computer for Timeshar- 
ing Application’, AF/PS Conf. Proc., Fall Joint Comput. Conf. 
27, Spartan Books, Washington, DC, 1965, pp. 197-202. 


V.A.Vyssotski, et al., ‘Structure of the Multics Supervisor’, 
AFIPS Conf. Proc., Fall Joint Comput. Conf. 27, Spartan 
Books, Washington, DC, 1965, 203-212. 


R.C.Daley and P.G.Newmann, ‘‘A General-Purpose File Sys- 
tem for Secondary Storage’, AF/PS Conf. Proc., Fall joint 
Comput. Conf. 27, Spartan Books, Washington, DC, 1965, 
pp. 213-229. 


|.F.Ossanna, et al., ‘‘Communication and Input/Output 
Switching in a Multiplex Computing System’, AF/PS Conf. 
Proc., Fall Joint Comput. Conf. 27, Spartan Books, Washing- 
ton, DC, 1965, pp. 231-241. 


E.E.David, Jr. and R.M.Fano, ‘Some Thoughts About the Social 
Implications of Accessible Computing’, AF/PS Conf. Proc., 
Fall Joint Comput. Conf. 27, Spartan Books, Washington, DC, 
1965, pp. 243-247, 


A.Bensoussan, C.T.Clingen and R.C.Daley, ‘‘The Multics Vir- 
tual Memory’, ACM Second Symp. on Operating Syst. Princi- 
ples, Princeton University, 30-42 (1969). 


C.T.Clingen, ‘‘Program Naming Problems in a Shared Tree- 
Structured Hierarchy”, NATO Sci. Committee Conf. on Tech- 
niques in Software Engg. 1, Rome, Italy (1969). 


R.M.Graham, “Protection in an Information Processing Util- 
ity’, Commun. ACM 11, No. 5, 306-312 (1968). 


F.j.Corbat6 and j.H.Saltzer, ‘‘Some Considerations of Supervi- 
sor Program Design for Multiplexed Computer Systems’’, /F/P 
Conf. Proc., Invited Papers, 66-72 (1968). 


R.C.Daley and }.B.Dennis, “Virtual Memory, Processors, and 
Sharing in MULTICS”, Commun. ACM 11, No. 5, 365-369 
(1968). 


F.j.Corbaté, ‘PL/I as a Tool for System Programming’, Data- 
mation 15, No. 6, 68-76 (1969). 


F.j.Corbatd, “A Paging Experiment with the Multics System”, 
In Honor of P.M. Morse, M.1.T. Pr., Cambridge, MA, 217-228 
(1969). 


J.H.Saltzer and ).W.Gintell, ‘The Instrumentation of Multics’”’, 
ACM Second Symp. on Operating Syst. Principles, Princeton 
University, 167-174 (1969), also in Commun. ACM 13, No. 
8, 495-500 (1970). , 


M.].Spier and E.!.Organick, ‘‘The Multics Inter-Process Com- 
munication Facility”, ACM Second Symp. on Operating Syst. 
Principles, Princeton University, 83-91 (1969). 


R.A.Freiburghouse, ‘The Multics PL/| Compiler’, AF/PS Conf. 
Proc, 35, AFIPS Pr., 187-199 (1969). 


C-~20 


17. 


18. 


19. 


20. 


21. 


22; 


23. 


].M.Grochow, “Real-Time Graphic Display of Timesharing 
System Operating Characteristics’, AF/PS Conf Proc., Fall 
Joint Comput. Conf. 35, AFIPS Pr., 379-385 (1969). 


J.H.Saltzer and |.F.Ossanna, “‘Remote Terminal Character 
Stream Processing in Multics’, AF/PS Cont. Proc., Spring Joint 
Comput. Conf. 36, AFIPS Pr., 621-627 (1970). 


j.F.Ossanna and J.H.Saltzer, “Technical and Human Engineer- 
ing Problems in Connecting Terminals to a Timesharing Sys- 
tem’, AF/PS Conf. Proc., Fall joint Comput. Conf. 37, AFIPS 
Pr., 355-362 (1970). 


D.D.Clark, R.M.Graham, J.H.Saltzer and M.D.Schroeder, 
“Classroom Information and Computing Service’, M.I.T. 
Project MAC Technical Report TR-80, (1971). 


M.D.Schroeder, “Performance of the GE-645 Associative 
Memory While Multics is in Operation’, ACM Workshop on 
Syst. Performance Evaluation, 227-245 (1971). 


M.D.Schroeder and ).H.Saltzer, “A Hardware Architecture for 
Implementing Protection Rings’, ACM Third Symp. on Oper- 
ating Syst. Principles, Palo Alto, CA, (1971). 


R.j.Reiertag and E.1.Organick, “The Multics Input/Output Sys- 
tem’, ACM Third Symp. on Operating Syst. Principles, Palo 
Alto, CA, (1971). 


M.I.T. Theses related to Multics 


1. 


10. 


1. 


J.H.Saltzer, ‘Traffic Control in a Multiplexed Computer Sys- 
tem”, Sc.D., MAC-TR-30, (1966). 


R.Rappaport, ‘Implementing Multi-Process Primitives in a 
Multiplexed Computer System’’, §.M., MAC-TR-55, (1968). 


H. Deitel, “Absentee Computations in a Multiple-Access Com- 
puter System”, 5.M., MAC-TR-52, (1968). 


).Greenbaum, “A Simulator of Multiple Interactive Users to 
Drive a Timeshared Computer System’, 5.M., MAC-TR-58, 
(1968). 


).M.Grochow, ‘‘The Graphic Display as an Aid in the Monitor- 
ing of a Timeshared Computer System’’, 5.M., MAC-TR-54, 
(1968). 


R.1.Ancona, “A Compiler for MAD-Based Language on Mul- 
tics’, S.M., (1968). 


D.Clark, “A Reduction Analysis System for Parsing PL/I", 
S.M., (1968). 


M.D.Schroeder, “Classroom Model of an Information and 
Computing Service’, §.M., (1969). 


C.M.Vogt, ‘Suspension of Processes’ in a Multiprocessing 
Computer System’, $.M., (1970). 


R.Frankston, “A Limited Service System on Multics’, $.B., 
(1970). 


R.R.Schell, “Dynamic Reconfiguration in a Modular Computer 
System”, Ph.D., (1971). 
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Deii 


FO 


LEVEL 68 CURRICULUM 
HONEYWELL MARKETING EDUCATION 


Operation 


6-8 Hour VAL 


General 
FO1 5-Days 
FO02 1-Day 
Languages 
G11 3-Days 
+F 11 2-Days 
+F 12 2-Days 
F13 5-Days 
F14 3-Days 
F15 5-Days 
F15C 3-Days 
F15D 5-Days 
F19 2-Days 
Data Base 
F32 3-Days 
F31 5-Days 
F30 2-Days 
Word Processing 
*F44 1-Day 
#FY2 3-Days 
F43 5-Days 
Administration and 
F60 5-Days 
F617 
F68 5-Days 
Applications 
+F 70 5-Days 
Operating Supervisor 
F80 5-Days 
+F 81 5-Days 
+F 86 5-Days 
Miscellaneous 
+F 90 3-Days 


Multies Concepts and Utilization 
Multics Features, Functions, and 
Benefits 


APL 

APL Specifics 

BASIC Specifics 

COBOL~74 Specifics 

FORTRAN Specifics 

Multics PL/I Programming 

Advanced PL/I Programming 

Application Subsystem Programming 
Techniques 

Advanced Program Debugging Techniques 


LINUS Utilization 
MRDS Utilization 
MRPG Utilization 


-WORDPRO Basic Utilization 


WORDPRO Advanced Utilization 
WORDPRO for Document Administrators 


System Administration 
Project Administration 
Operator Training 


Graphics Programming 


Multics Process Management Analysis. 
Multics Failure Analysis and Recovery 
MCS Concepts and Implementation 


GCOS Environment Simulator 
Utilization 


+ Not currently available (December, 78) 
* Conducted on-site by special request only 


D-1 FO1 


LANGUAGES 


COURSE SELECTION GUIDE 


RECOMMENDED | SUPPLEMENTAL/OPTIONAL 

MULTICS CONCEPTS AND UTILIZATION FUNDAMENTALS OF EDP e 

_ CLASSROOM 5-DAYS GO14 6-8 HRS 
<p PROGRAMMING LOGIC & FLOWCHARTING 


36-44 HRS 


PL/I CONCEPTS 
CLASSROOM 2-DAYS 


DECISION TABLES 


COMMERCIAL PL/I PROGRAMMING G527 VAL 12-16 HRS 
FLI5A CLASSROOM 3-DAYS 


MULTICS FEATURES, 
FUNCTIONS & BENEFITS 


SCIENTIFIC PL/I PROGRAMMING ae 
F15B CLASSROOM _3-DAYS a 
ADVANCED PROGRAM DEBUGGING TECH. 


CLASSROOM 2—DAYS 


ADVANCED PL/I PROGRAMMING 
F15C CLASSROOM 3-DAYS 


APPLICATION SUBSYSTEM PROG. 
F15D CLASSROOM 5-DAYS 


COBOL PROGRAMMING COBOL CONCEPTS 
G434 30-36 HRS 6334 12-15 URS 


COBOL-74 PROGRAMMING SPECIFICS BASIC) 
CLASSROOM 5-DAYS 


BASIC (PROGRAMMING LANGUAGE) _ 
ADVANCED PROGRAM DEBUGGING TECH. C6537 VAL 12-16 HRS 


CLASSROOM 2-DAYS a 


BASIC SPECIFICS 
F12 VAL 12-16 URS 


FORTRAN IV LANGUAGE , 
Gou7 VAL (| 30-34 HRS C APL > 
“APL (PROGRAMMING LANGUAGE) _ is 


FORTRAN SPECIFICS 
CLASSROOM 3-DAYS 


[ Fl LASSROOM 3-DAYS oor 
| | Lass APL SPECIFICS ——__ ae 
S 


CLASSROOM | 2-DAY 


DATA BASE 


COURSE SELECTION GUIDE 


RECOMMENDED SUPPLEMENTAL /OPTIONAL 


MULTICS CONCEPTS & UTILIZATION FUNDAMENTALS OF EDP 7 
| Fol | CLASSROOM 5-DAYS GO14 CLASSROOM 6-8 HRS 


LINUS & REPORT GEN. UTILIZATION 


F32 CLASSROOM 5-DAYS 
[ COMMERCIAL PL/I PROGRAMMING | DATA BASE CONCEPTS _—_—_—i 
FL5A_ CLASSROOM 3—DAYS G078 1BR “1-HR 


COBOL-74 SPECIFICS 


CLASSROOM 15-DAYS 


MULTICS FEATURES, 
FUNCTIONS & BENEFITS 


F13 


MRDS UTILIZATION WITHIN 
APPLIC. PROG. 


F31 CLASSROOM 5-DAYS 


ADMINISTRATION AND OPERATION 


COURSE SELECTION GUIDE 


RECOMMENDED SUPPLEMENTAL /OPTIONAL 


ADMINISTRATIO 


MULTICS CONCEPTS & UTILIZATION 
CLASSROOM 5-DAYS 


FUNDAMENTALS OF EDP : 
Go14 [| ST Cf6-8 HRS 


MULTICS FEATURES, 
FUNCTIONS & BENEFITS 


PROJECT ADMINISTRATION 
FolA VAL S46 HRS 


SYSTEM ADMINISTRATION 
F60 CLASSROOM 5-DAYS 


OPERATION 


OPERATOR TRAINING 
CLASSROOM _| _5-DAYS 


N-4 


OPERATING SUPERVISOR 


COURSE SELECTION GUIDE 


RECOMMENDED SUPPLEMENTAL/ OPTIONAL 


MULTICS CONCEPTS & UTILIZATION | | ._ FUNDAMENTALS OF EDP 
{Fol | ___- CLASSROOM 5-DAYS Gol4{_ ST 6-8 ORS. 


PROGRAMMING LOGIC & FLOWCHARTING | 
G024 36-44 HRS 


DECISION TABLES 


| 6527 12-16 HRS_ 


[ MULTICS FEATURES, 
FUNCTIONS & BENEFITS | 
FO27] VAL | 6-8 HRS 


PL/I CONCEPTS 
G15 CLASSROOM 2-DAYS 


COMMERCIAL PL/I PROGRAMMING 


F15A CLASSROOM | 3-DAYS 


ADVANCED PL/I PROG. TECHNIQUES 
F15C CLASSROOM 3-DAYS 


APPLICATION SUBSYSTEM PROG. TECH. 
F15D CLASSROOM 5~DAYS 


SYSTEM ADMINISTRATION 
60 CLASSROOM 5-DAYS 


MULTICS PROCESS MGMT. ANALYSIS | 
80 CLASSROOM 5-DAYS 


hy 


rxj 


OPERATOR TRAINING 
F68 CLASSROOM 5-DAYS 


MULTICS FAILURE ANALYSIS & RECOV. 


CLASSROOM 


COMMUNICATIONS ‘ 


COURSE SELECTION GUIDE 


RECOMMENDED 


MULTICS CONCEPTS & UTILIZATION | 
1 


Uli a 
CLASSROOM 5-DAYS 


COMMUNICATION CONCEPTS 
_ CLASSROOM 2~DAYS. 


MCS CONCEPTS & IMPLEMENTATION 


CLASSROOM 5-DAYS | 


SUPPLEMENTAL / OPTIONAL 


FUNDAMENTALS OF EDP 1] 


6-8 HRS | 


COMMUNICATIONS CONCEPTS (BASIC) 
G064 6-8 HRS 


COMM. SYS. ANALYSIS & DESIGN 
"CLASSROOM 5-DAYS 


MULTICS FEATURES, FUNCTIONS, 
& BENEFITS 


APPLICATIONS AND MISCELLANEOUS 


COURSE SELECTION GUIDE 


RECOMMENDED 


\ 


MULTICS CONCEPTS & UTILIZATION 
CLAS SROOM 5-DAYS 


GRAPHICS PROGRAMMING 
F70 CLASSROOM 3-DAYS . 


GCOS ENVIRONMENT SIMULATOR UTIL. 
F90 CLASSROOM 3-DAYS 


SUPPLEMENTAL / OPTIONAL 


MULTICS FEATURES, 
FUNCTIONS & BENEFITS 
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COMMANDS/MANUALS CROSS-REFERENCE 
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‘Bedi _FO1 


AG92/r2 
AG92/re 
ARQ7/aA 
ARO7/aA 
AK92/aB 
AG92/r2 
AG92/r2 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AG92/re 
AG93/aD 
- AG92/re 
AG92/re 
AN52/r0 
AK92/aB 
AS68/r0 
AG92/r2 
AG92/re2 
AG92/re2 
AG93/aD 
AK50/r0 
AK92/aB 
AK92/aB 
AK92/aB 
AK92/aB 


AN52/r0 
AK92/aB 
AK92/aB 
AG92/re2 
AG92/re2 
AG92/re 
AG92/re2 
AGQ2/re2 
AGY2/re2 
AG92/re2 
AGQ2/r2 
AG92/re2 
AK92/aB 
AK92/aB 
AK92/aB 
AK92/aB 
AK51/r1 
AK92/aB 
AK9Y2/aBb 
AZ03/r0 
AZ03/r0 


COMMANDS/MANUALS CROSS REFERENCE 


029and963 
MAP 
TEST 
TSTCHN 
aa 
ab 
abbrev 
abbrev 
abbrev $abbrev 
abbrev _$expanded_ line 
abbrev _$set cp 
abe 
absolute _pathname- 
ac 
accept messages 
acm 
active fne err _ 
add_anon 
add name 
add search rules 
adjust_ bit count 
adjust bit count_ 
admin util 
aim_ check 
aim_ ~ check | _$equal 
aim_ - check | _$greater 
aim check _$ 

greater or equal 
alarm clock meters 
alm: ~~ - 


(BOS) 
(BOS) 


and (AF) 

ans 

answer 

apl 

ar 

archive 

archive sort 
area _info_ 

area Status 

aS 

as_who 

ascii _to_ebcdic_ 
ascii to ebcedic $table 
ask 

ask $ask_ 


AZO3/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ0O3/r0 
AZ03/r0 
AZO3/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AG92/re 
AK92/aB 
AG92/r2 
AG92/r2 
AG92/re 
AG92/re 


AS68/r0 
| AGQJ2/re 


AG92/re2 
AG92/r2 
AG92/re2 
AG92/re2 
AG92/r2 
AG92/re2 
AG92/r2 
AG92/re2 
AG92/re2 
AG92/re2 
AG92/re2 
AG92/re2 
AG92/re2 
AS68/r0 
AS68/r0 
AS68/r0 
AGQ2/r2 
AG92/re2 
AZ03/r0 
AN52/r0 
AG92/re 
AG93/aD 
AS68/r0 
AK50/r0 
AS68/r0 
AK50/r0 
AG92/re2 


ask $ask c 

ask $ask cflo 
ask —$ask_ cint 
ask $ask cline 
ask ~$ask_ elr 
ask _$ask_ flo 
ask $ask int 
ask $ask line 
ask _$ask_ n 

ask $ask nflo 
ask $ask nint 
ask $ask nline 
ask $ask prompt 
ask $ask_ setline 
asr 

assign 

assign resource 
attach lv 

basic 


branches 
cale 
cancel abs request 
cancel cobol program 
cancel _ daemon _request 
ear 
eep 
cd . 
edr 
cdwd 
ceil 
cem 

ef 
chaddr 
chalias 


change 
change default 


we EUR YY 


change error mode 

change kst attributes 
change tuning parameters 
change wdir _ 

change wdir_ 

charge 

charge disk 

echdf proj 

check dir 

check iacl 


(AF) 


CAF) 


wdir 
wey NA HE 


FO 4 


AG92/r2 
AS68/r0 
AZ03/r0 

K50/r0 
AZ03/r0 
AN53/rU 
AK92/aB 


AK92/aB 


AK92/aB 
AS68/r0 
AS68/r0 
AS68/r0 
AG92/re2 
AZ03/r0 
AK50/7r0 
AZ03/r0 
AK50/r0 
AK50/r0 
AK50/r0 
AG93/aD 
AG92/r2 
AG92/re2 
AK50/r0 
AZ03/r0 
AG92/re2 
AG93/aD 
AG93/aD 
AG93/aD 
AG93/aD 

K50/r0 
AZ03/r0 
AG92/re2 
AG92/re2 
AK50/r0 
AZ03/r0 
AK50/r0 
AZ03/r0 

K50/r0 
AK92/aB 
AG92/re2 
AKY2/aB 
AK92/aB 
AG93/aD 
AGY3/aD 


AGY3/aD 


AGY3/aD 


COMMANDS/MANUALS CROSS.-REFERENCE 


check info segs 

check log 

check mdes 

check mst 

check mst 

check sst 

check — star name 

check star name _$entry 

check star name $path 

chname 

chpass 

chprog 

eis 

cka 

ckm 

ekm 

clean card pool 

clear projfile 

clear reqfile 

clock 

close file 

co 

cob 

cob 

cobol 

com_err_ 

com_ err 

com err _$suppress_ name 

command query 

comp dir info 

comp dir _info 

compare 

compare ascii 

compare mst 

compare mst 

compare object 

compare object 

compute bill 

condition _interpreter_ 

console output 

continue_ to signal 

convert _ aim _attributes | 

convert _ _authorization 

convert authorization _$ 
decode 

convert authorization $ 
encode 7 

convert authorization _$ 
from string 


AG93/aD 


AG93/aD 


AG93/aD 


AG93/aD 
AG93/aD 


AK92/aB 
AK92/aB 
AG92/re 
AG92/re2 
AK50/7r0 
AG92/re 
AN53/r0 
AN53/r0 


AN53/r0 


AN53/r0 
AG92/r2 
AG92/re2 
AG92/re2 
AZ03/r0 
AK92/aB 
AN53/r0 
AK50/r0 
AN53/r0 
AG92/re2 
AG92/re2 
AG92/re2 
AZ03/r0 
AG92/re 
AG93/aD 
AG92/re2 
AG92/re2 
AK92/aB 
AK50/7r0 
AK50/r0 
AG92/re 
AZ03/r0 
AS68/r0 
AK50/r0 
AZ03/r0 
AK50/r0 
AZ03/r0 
AN52/r0 
AS68/r0 
AG93/aD 


convert authorization $ 
minimum 

convert authorization $ 
to string 

convert authorization _$ 
to string _ Short 

convert date to binary 


convert date to binary $ 


relative 
convert dial message 
convert status code 
copy 
copy acl 
copy as meters 
copy cards 
copy dump 
copy dump$set fdump num 
copy _dump$sfdn 
copy dump seg 
copy file 
copy iacl dir 
copy iacl seg 
copy mst 
copy names 
copy out 
copy pnt 
copy salvager output 
ep a 
cpa 
epf 
cpm 
Cpt 
cpu time and paging 
cr ~ - = 
create 
create area 
create cmf 
create daemon queues 
create dir 
create ips mask 
credit ~ 
cref. 
cref 
cross reference 
cross reference 
ectp 
cu 


AK92/aB 
AK92/aB 
AK92/aB 
AK92/aB 
AG93/aD 
AK92/aB 
AG93/aD 
AK92/aB 
AK92/aB 
-AG93/aD 
AK92/aB 
AK92/aB 
AK92/aB 
AK92/aB 


AK92/aB 
AK92/aB 
AK92/aB 
AK92/aB 
AK92/aB 
AK92/aB 
AK92/aB 


AK92/aB 
AK92/aB 
AK92/aB 
AK92/aB 
AG92/re 
AK92/aB 
AK92/aB 
AK92/aB 
AK50/r0 
AK92/aB 
AK92/aB 
AK92/aB 
AK92/aB 
AK51/r1 
AK92/aB 
AG92/re 
AG92/re 
AGY2/re 
AK50/r0 

K50/r0 
AK50/r0 
ARQ7/aA 
AG92/re 
AZ03/r0 
AG92/re 
AG93/aD 


COMMANDS/MANUALS CROSS-REFERENCE 


cu 
cu $af arg count 
cu Sar: arg ptr 
cu | $af_ return _arg 
cu _$arg count — 
cu_$arg list _ptr 
cu_$arg ptr 
cu $arg ptr rel 
cu $cl 
cu_$ep 
cu $decode _entry value 
cu _$generate | eall 
cu  $get_ cel _intermediary 
cu $ 

get_ command processor 
CU _$get_ ready mode 
cu_$get ready procedure 
cu $level get 
cu $level set 
cu $ready proc 
cu_$set_cl_ intermediary 
cu_$ 

set command processor 
cu_$set_ready mode 
cu | $set_ _ready_ procedure 
cu $stack frame ptr 
cu_$stack frame size 
cumulative _page trace 
ev bin 
cv bin $dec 
cv_ bin $oct 
ev emf 
ev_entry_ 
ev hex 
cv oct 
CV [OG check 
ev pmf 
GV ptr 
cwd 
d 
da 
daily log process 
daily summary 
daily syserr_ process 
daily syserr process 
date (AF) 
date deleter 
date time (AF) 
date time_ 


AG93/aD 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 


AZ03/r0 
AZO3/r0 


AZ03/r0 


AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AZ03/r0 
AS68/r0 
AG92/re 
AG92/re2 
AG92/re2 
AK92/aB 
AG92/re2 
AG92/re2 
AZ03/r0 
AG92/re 
AG92/re2 
AG93/aD 
AZ03/r0 
AZ03/r0 
AZO03/r0 
AK92/aB 
AG92/r2 
AG92/r2 
AK92/aB 
AS68/r0 
AG92/re2 
AG93/aD 
AG93/aD 
AG93/aD 
AG92/r2 
AG92/re 
AK92/aB 


AG92/re 
AG92/re2 


E~3 


date time _$fstime 
datebin 
datebin $clockathr 
datebin $datebin 
datebin $datofirst 
datebin _$dayr_ clk 
datebin _$dayr_ mc 
datebin $ 
following midnight 
datebin $last midnight 
datebin $ 
next shift _change 
datebin $ 
preceding midnight 
datebin $revert 
datebin $revertabs 
datebin $shift 
datebin _$this _midnight 
datebin $time. 
datebin $wkday 
day 
day (AF) 
day name 
db 
den 
der 
dd 
deactivate seg 
debug 
decode 
decode clock value 
decode definition 
decode definition $full 
decode definition “$init 
decode | descriptor 
default (AF) : 
defer messages 
define area 
delegate 
delete 
delete 
delete $path 
delete $ptr 
delete acl 
delete dir 
delete external _ 
variables 
delete force 
delete iacl dir 


(AF) 


FO1 


AG92/re2 
AG92/r2 
AGY2/re2 
AKb50/r0 
AG92/re2 
AGQ92/re 
AN52/r0 
ARQ7/aA 
AG92/re 
AG92/re 
AK92/aB 
AG92/re 
AG92/re 
AG92/re2 
AG92/re2 
AG92/re2 
AG93/aD 
AN52/r0 
AS68/r0 
AK50/r0 
AK51/r1 
AK50/r0 
AK50/r0 
AZ03/r0 
AG92/r2 
AK92/aB 
AZ03/r0 
AG92/re2 
AG92/re2 
AG92/re 
AG92/re2 
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delete name 
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hes _$ 
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hes _$ 
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hes _$set max _length 
hes $set_max _length_seg 
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hes $set_ safety sw 
hes _$set_ safety_ Sw_ seg 
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hes _$star_ Last. 
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hes _$status _ minf 
hes $status mins 
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help 
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hpda 
hphes $add cpu 
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hphes $add_mem 
hphes $add pd records 
hphes $del cpu 
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hphes _ _$del_ mem 
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hphes | $re force _unlock 
hphes | _$reconfig | “info 
hpsa 
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hunt 
icref 
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im 
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ind ~ ci 
indent 
index (AF) 
index set 
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install 
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ioa $ioa stream 
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ioa _$nnl- 
ioa $rs 
ioa $rsnnl 
ioa_$rsnp 
ioa $rsnpnnl 
iod info 
iod info $ 
driver access name 


iod info _$generic type 
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iox_ 

10x 

iox $attach iocb 
iox $attach ioname 
iox $close 

iox $control 

iox $delete record 
10x _$destroy_ iocb 
10x _$detach_ ioeb 
iox $err no operation 
iox $err_not_ attached 
iox_$err_not closed 
10x _$err_ not | _open 
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iox $find iocb n 
iox $get_chars 

iox _$get_ line 
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iox $modes 

iox $move attach 
iox $open | 

iox_ $position 

iox $propagate 
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ipe $mask_ ev. calls 
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ipe ~ $reconnect 
EC _$set_ eall prior 
Ipc _$set_ wait prior 
ipe _$unmask | eV Calls 
is_ he user 
is legal proj 
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1 
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lac 
lar 
last_message (AF) 
last_message sender (AF) 
last message time (AF) 
ldr 
length (AF) 
less (AF) 
lex error 
lex string_ 
lex string —$ 
init lex delims 
lex _string_ ~ $lex 
Lid: 
line length 
link 
link meters 
link: ; unsnap _ 
links (AF) 
lis 
list 
list abs requests 
list accessible 
list acl 
list daemon requests 
DUSte _delegated {projects 
list dir info 
list dir info 
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list iael dir 
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list_mst 

list not accessible 
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Jist resources 
list_temp segments 
lk 


lkm 
ll 
lm 
lms 
lmt 
lnac 
load _ctl_ status 
login 
logout 
long date 
lr 
Irn 
ls 
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mail 
mailbox $add_ index 
Mailbox $ 

check salv_ bit index 
mailbox $chname 
mailbox $close 
mailbox $create 
mailbox $delete 
mailbox _$delete_ index 
mailbox $ 

get message _ 

count index 

mailbox $get_mode index 
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incremental read index 
mailbox $open 
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read delete index 
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merge mst 
message segment $ 
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ms_ delete 

ms delete 
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ms rename 
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ms set acl 
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SECTION I 


INTRODUCTION 


The purpose of this document is to aid the user in understanding 
errors that may occur during use of Multics. The standard Multics 
error reporting mechanism is introduced, and the meaning of error 
messages is explained. Possible causes of many errors are discussed, 
and when applicable, methods for recovering from, or circumventing an 
error are presented. 


HOW TO READ THIS DOCUMENT 


This document is intended for use by novice users or applications 
programmers unfamiliar with the Multics programming environment. As a 
result, the kinds of errors covered and the examples given have _ been 
tailored to this audience. 


The discussion of error conditions is divided into four sections. The 
first explains command processor errors. This includes all errors 
that arise in the interpretation of commands, and the formation of 
command names and command arguments. The second section, entitled 
"Command Errors", deals with errors that are detected by commands 
themselves. For example, an editor will report = an error when a 
request is issued to read a nonexistant file. The third section 
discusses execution errors: hardware (simulated) conditions that 
arise during the execution of programs. Examples of this class of 
errors include zero divide, subscript range, and segment fault. Such 
errors may occur in user or system programs and generally indicate the 
presence of a program bug. AS a result, this section is of the 
greatest use to programmers creating and debugging a new program. The 
fourth section covers fatal process errors. These are similar in 
origin to execution errors, but cause the user's. process to be 
aborted. Language-specific errors such as input/output, BASIC run 
time errors, etc. are not covered by this memo. 


Each section describes the most commonly occurring errors of the 
particular class. Console scripts, along with descriptive 
commentaries, are used to present typical examples of the error, the 
methods used to determine the actual cause of the error, and means for 
recovering from the error. The memo is partially tutorial; however, 
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for complex explanations, the user will be referred to the MPM. 


This document may be used as a reference for individual errors. 
However, it is felt that the reader would benefit by at least one 
reading from cover to cover. This should provide experience with 
errors that otherwise could only only be obtained by a long period of 
actual use. Furthermore, many errors have related causes and 
consequently related methods for analysis, and since, in general, a 
topic is explained in full detail only once, a thorough reading will 
help the user see how a specific technique or error falls into the 
overall scheme. Finally, the reader should find a_ number of 
worthwhile hints that enable him or her to avoid problems in the first 
place. 


User feedback is solicited concerning errors in this document, awkward 
or incomprehensible explanations, common problems that have been left 
out, etc. 


THE PROGRAMMING ENVIRONMENT 


heir causes, it is 


h programs run. (Often, 


Bn am Foo Stee e 
helpful to understand the environment in wh 


too, it is simply a misunderstanding that is the cause of the error.) 
Below is a brief and simplified discussion of the basic features and 
terminology of the Multics programming environment. Refer to the MPM 
Reference Guide (Order No. AG91) for more detailed information. 


To obtain a good understanding of errors’ and 


A process is a computation or execution activity much like a job on 
other computer systems. The term refers, collectively, to the program 
or group of programs in execution, the current value of program 
variables, the address space (the temporary and permanent segments of 
memory that have been referenced), the files and other’ input/output 
devices (e.g., console, tape volumes) in use, and various 
system-maintained data bases. What is important to the programmer is 
the duration of the process, since it maintains the programming 
environment. When the user first logs in (1) a new process is 
created. At this time, all per process information is put into a 
consistent initial state. There are no files or devices attached 
besides the terminal; all program variables are (in effect) set to 
their initial values; and so forth. A process is terminated when the 
user logs out, gives the new_proc command, or a fatal error occurs. 


On Multics, programs and their data reside in a virtual memory or 
address space. This consists of (potentially) a large number of 
disjoint segments of storage. Fach such segment may contain up to 
255K (K = TOST) words of storage, and has a name by which it may be 
accessed. An address (pointer) designating a specific location in the 


(1) Or equivalently an absentee job is logged in at the user's request 
by the system, in which case, the console is replaced by the absentee 
input segment. 
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virtual address space is a pair of numbers: a segment number and an 
offset within the segment. When a segment is to be used, it is 
initiated forming a mapping between the name and a segment number. 
This mapping remains valid for the duration of a process, or until the 
segment is explicitly terminated. Use of an invalid segment number, 
in particular a segment number’ generated in another process, is a 
common source of errors. (See the description of the segment fault 
error.) An offset within a segment, on the other hand, remains valid 
as long as the contents of the segment are not modified. This means, 
for example, that it is possible to save the offset part of an address 
across processes and reuse the offset with a segment number generated 
in the new process. (1) Errors occur in the use of offsets if the 
value of the offset is out or range: negative or greater than 255K. 
(A lower limit can be set by explicit programmer action, if desired.) 
See the discussion of out of bounds errors. 


A segment may be designated by one of two naming conventions: 
pathnames and reference names. In general, a segment is specified by 
pathname when accessed by commands, and by reference name when 
accessed from a program as an external symbol (e.g., the name of an 
external subroutine). 


A pathname designates an unique segment within the Multics file 
system, Every segment has one or more entrynames by which it is 
cataloged in a directory. Within a single directory, the entrynames 
of all entries are unique; entrynames of entries in different 
directories need not be distinct. In addition to segments, a 
directory may contain other subdirectories. The Multics file system 
is organized as a tree with a root directory that contains all other 
cirectories as subdirectories, subsubdirectories, etc. 


(1) PL/I programmers may realize the similarity between this and the 
restrictions on the use of based areas and offsets on other systems. 
Programs are not allowed to save pointers to data allocated within the 
area from job to job because while the area may retain its integrity, 
the actual address may change. The same reasoning applies to segment 
numbers and offsets, and to areas on Multics saved from process’ to 
process, ae 
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(a) (fh: 


A pathname, then, is an ordered list of entrynames designating the 
directories containing the entry and the entry itself. It gives the 
path from the root to the segment. In the diagram above, squares 
represent directories and diamonds represent segments. The following 
are all valid pathnames within that hierarchy: 


>di>da 
>»d2>a 
»d2>aa 


In addition to segments and dir:ctories, a directory may also contain 
links. A link is a pathname pointing to another entry (usually in 
another directory); it allows that entry to be accessed as if it were 
cataloged in the directory containing the link with the name(s) of the 
link. In the diagram above, links are presented by triangles with 
dotted lines leading to the target of the link. 


2d1>¢ and »d2>a, 
and >d1i>do>f and >d2>d 


refer to the same directory and segment respectively. If ae link 
points to another link, then the entry pointed to by the second link 
becomes the ultimate target. 

There are two forms of pathnames. An absolute pathname contains’ the © 
entrynames of all the containing directories; that is, it fully 
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specifies the position of something (i.e., segment, directory, link) 
within the directory hierarchy. A relative pathname, on the other 
hand, gives the position of an entry relative to the workin 

directory. A relative pathname is expanded into an absolute pathname 
by logically concatenating the pathname of the working directory to 
the relative pathname given. For example, if the working directory 
were >d2>a from the the diagram above, the relative patnname "*f" would 
be the same as the absolute pathname >d2da>f. It is possible to move 
upwards in the hierachy by using "<"s in a relative pathname. Thus 
with the same working directory as above, <d would be the same as 
>d2>d. The working directory is initially the user's home directory, 
normally >udd>Project ID>Person ID; it may be changed by the user 
with the change wdir (ewd) command. Absolute pathnames are 
distinquished from relative ones by a leading ">". 


The term segment is often confused with the term file. Strictly 
speaking, a file is storage accessed through explicit input/output 
operations. In principle, there are no limitations on the size of a 
file; it may get as large as is necessary, far exceeding the 255K 
word limit of a segment. Those files smaller than 255K are placed in 
a Single segment. Unstructured files of character data are the same 
as text segments. That is, they may be created or modified in an 
editor, printed, or sorted. Structured files (those containing 
nonprintable "binary" data) should not be acessed except through I/0 
facilities. Those files larger than 255K are implemented as 
multisegment files. The data is stored in several segments’ which 
should. only be accessed by I/O mechanisms. Even if the file contains 
only printable text, there are currently no mechanisms for editing it 
and guaranteeing the authenticity of the file. A multisegment file is 
cataloged in a directory like any other entry. In this memo, the 
distinction between file and segment will be strictly adhered to. 


A reference name is the name by which a segment is referenced (e.g., 
called) during the execution of a program. It consists of the 
entryname of the segment; the absolute pathname of a particular 
segment is determined by applying the search rules in effect for the 
process. They are as follows. 


1. A list of reference names already known within the process is 
checked; if the entryname being searched for is found, the 
associated segment is used. A name becomes known when the 
search rules are first used to reference a segment with that 
entryname or when a specific segment is initiated and a 
reference name (which need not be an entryname of the segment) 
is specified for the segment. 


2. The directory containing the program making the reference is 
checked for a segment with the entryname. If found, the 
“segment found becomes known by the reference name. 


3. Each of an ordered list of directories is checked for a 


Segment with the correct entryname. If found, the segment 
becomes known by the reference name. Initially, this list 
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starts with the user's working directory and is followed by 
the list of system libraries. Alterations may be made to this 
list of directories by using the add search rules’ command. 
For example, the working directory (which is logically 
specified as "working dir" and whose meaning changes as_ the 
working directory is changed) may be moved to follow the 
system libraries, or a specific user directory may be added to 
the search rules. ; 


Once a reference name is associated with a particular segment, it 
remains in effect (rule 1) until the process is terminated or until 
the segment is terminated by using the terminate command. This can 
cause unexpected results for the unsuspecting user. In the sample 
hierarchy given above, if the user's current working directory is >d1 
and he or she executes the procedure a in that directory, it will 
become known by the reference name a. If later, he changes to a new 
working directory, >d2>a, and executes the procedure f which calls a 
subroutine a, then the segment with reference name a found by the 
search rules will not be the segment >d2>a>a, but rather the segment 
previously known by that reference name, >d1>da. 


For each process, the system creates a rocess directory. This 
enanrisa 


directory contains temporary data segments an 


d special segments in 
which program data and system control information are_ stored. The 
stack is one such segment and contains records of current procedure 
activations and the automatic storage used by these procedures. The 
combined linkage segment contains the linkage sections of procedures 
which hold the internal static data used by a program. The identity 
of these segments can be important in determining the cause of an 
error. When an error occurs, the segment containing the data being 
referenced will be given when appropriate. If the segment is the 
stack, it is a strong clue that the operation causing the error was 
making use of a datum of automatic storage. Similarly if the segment 
is the combined linked segment (combined linkage r.nn), it is likely 
that static data is involved. Often such a clue can be used to 
isolate the cause of an error in the absence of other debugging 
information such as the line on which the error occurred. a 


The list of procedure calls contained in the stack is an extremely 
useful source of debugging information. Consider the following 
example. Assume that a procedure A is executing. It then calls 
procedure B. Bin turn calls C. When C has finished executing, it 
returns and B continues from the point at which it called C. B 
eventually returns, and A then calls the procedure C. At each. step, 
it is possible to construct an ordered list of the procedure 
invocations indicating which program called which other program = and 
the location in a program at which it called out. Graphically, this 
list may be represented as follows: 


B 
A 


B C 
A A A 


POON 


A calls B B calls C C returns B returns A calls C 


In the figure above, the most recently called procedure is on top. 
Such a stack trace is particularly useful to understand the sequence 
of calls that lead up to an error. The probe and trace stack commands 
may be used to obtain a stack trace. Examples of the use of the probe 
command are given in later sections. A block is activated when a 
procedure or subroutine is called or a begin block is entered. 
Activation causes dynamic allocation of storage for a program's 
automatic variables. The area allocated is placed at the end (top) of 
the process's stack and is called a stack frame. When the procedure 
returns, the stack frame is freed. This means that variables of the 
automatic storage class (1) only have storage assigned to them (and 
hence a legitimate address and value) when the block in which they are 
declared is active (i.e., its execution is ongoing or suSpended as the 
result of an error condition, a quit signal, a call, or a debugger 
breakpoint). When a procedure is called recursively, it has frames on 
the stack for each activation. Each instance of the procedure on the 
stack is considered a separate and distinquishable activation of the 
procedure. The values of automatic variables and parameters can be 
(and usually are) different in different activations of the same 
procedure. 


Within a process, PL/I static variables and Fortran variables have a 
continuity of value. That is, the value of such a variable is 
initialized only once during a process, when a program in which the 
variable is defined is first invoked; subsequent modifications to the 
value of the variable will remain in effect, even through new 
activations of the procedure, until the process is terminated. (2) 


(1) PL/I variables, by default, belong to the automatic class. 
FORTRAN variables appearing in an automatic statement (a nonstandard 
Multics feature) are also of this class. 


(2) PL/I internal static variables or Fortran variables that are not 
in common may be reinitialized by terminating the segment. External 
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CONVENTIONS 


The examples in this document follow certain conventions. All lines 
typed by the user are prefixed by an exclamation point ( ). A quit 
signal issued by the user by pressing the QUIT, ATTN, or BREAK keys on 
the terminal is indicated by "(quit)" appearing to the left of the 
normal text of the example. When a line of output is too long to be 
placed on a single line, it is broken at an arbitrary point. This 
should not affect the user's understanding of the example. In ready 
messages output by the system on the completion of a command line, a 
dot (.) replaces information, such as the time of day, irrelevant to 
the example being presented. Finally, many lines of input or output 
whose content should. be obvious from the example is replaced by 
ellipsis (...). In all other respects, an attempt has been made _ to 
produce examples which are accurate. Most are simply modifications of 
the output from test error situations. 


and commoned variables may be rein alized only by using e new prov 
command to obtain a new process. 
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SECTION II 


COMMAND PROCESSOR ERRORS 


These are errors that are detected by the command processor When this 
kind of error is detected, a message is printed on the console, (along 
with a ready message), and then the system waits for the user to type 
another command. Once the cause of the problem has been determined, 
the user may retry the (corrected) command. 


These errors may often be caused by a garbled telephone connection 
between the user's terminal and the computer. If there is no apparent 
cause for an error, reenter the same command line again. 


SEGMENT NNNN NOT FOUND 


This means that reference name NNNN did not match any reference or 
entryname within the user's search rules. The most common cause of 
the error is incorrectly specifying (through mistyping or a 
misconception) the command name. ~ 


For example, suppose that a user had a program called colour, but 
mistakenly typed "color" when calling it: 


color — 

Segment color not found. 
r e@e6e@6¢¢@ 

list 

Segments = 3, Length = 3. 
re 1 colour 

row 1 colour.pli 

rew 1 PJApple.mbx 


r eeoee 


colour 
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Here the user gets the error, then uses the list command to see if 
there was something wrong with the name. Finding the mistake, the 
command line is retyped with the corrected name. | 


This error is virtually identical to the "Segment not found" case of 
linkage errors. See that discussion below for additional examples. 


ENTRY POINT EEEE NOT FOUND IN SEGMENT 
This ind a segment matching the reference name NNNN- was 
found i : search rules, but it did not contain the entry 
point called EEEE. To determine what entry points are actually 
present in a program (or other type of object segments) the 
print link info command may be used. 


colour 
Entry point colour not found in segment colour. 
r @eee 


pli colour -entry | 


colour 62/65/76 1546.4 est Thu 
3 Definitions: 
segname: colour 
symbi0 symbol_ table 
texti17 colour Entry: texti17 
r ee@e8e 
colour$color 


In the above example, a segment matching the reference name colour 
(see previous example) was found but it did not contain an entry point 
"colour". The pli command gives the "Segname" or the name by which 
the program was known when it was compiled; the only "entry" defined 
is one called "color", The user corrects the line by giving a command 
name that contains both the reference name and entry point’ name 
separated by a "$". Another way to correct the error would be to 
rename the program (both the source and the object segments ): 


rename colour.** color.s=s 
r eee : 


color 
l eae 


In this way, the segment now has the same entryname and entry poin’ 
name and can therefore be called as a command by giving only it: 
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entryname. (1) 


The problem illustrated here occurs quite often when the program 
contains a procedure with a different name than that given to the 


segment containing the text of the program. 


edm colour.pl1 
Input. 
color: procedure; 


end color; 


Edit. 
W 


q 
r @eees 


There are a number of other causes for this error. The entrypoint may 
have been deleted by binding. 


This error is virtually identical in cause to the "external definition 
not found" case of linkage errors. See that discussion below for. 
additional examples. If the meaning of reference names’ versus 
entrynames and entry point names is confusing, see the MPM Reference 
Guide, Section III, Constructing and Interpreting Names. 


“EXPANDED COMMAND LINE IS TOO LONG 


This error arises when an active string has been used, and the string 
returned overflows the currently allocated size for the command line. 
The user may recover by using the set com line command to set the 
command line length to some arbitrarily large value (e.g., 3000) and 
reissuing the command line. Below, the active string segs is invoked 
to return a string containing the names of all PL/I and Fortran source 
segments; this string overflows the command line length. 


archive ad saved_programs [segs *.p11 *. fortran] 
command processor_: Expanded command line is too long. 


th 
[ eeeoe 


set_com_line 3000 
r eee 


archive ad saved programs [segs *.pl1 *.fortran] 
r eeeeé 


(1) For an explanation of the star and equals convention, see the MPM 
Reference Guide, Section III, Constructing and Interpreting Names. 
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IMPROPER SYNTAX IN COMMAND NAME 


This error is issued when the user has specified a command name which 
is not in the standard form of a reference name, optionally followed 
by the special character "$" and an entry point name. Examples of 
correctly formed command names are: 


ref name ref _nameg$entry point_name 
Examples of incorrectly formatted names are: 
name$ | $name 
More detailed information may be found in Section III of the MPM 
Reference Guide. 
BAD SYNTAX IN PATHNAME 
This means that the program to be invoked was specified by an 


incorrectly formed absolute or relative pathname. See the discussion 
of the error in the Command Errors section. 


PARENTHESES DO NOT BALANCE 


This means simply that a parenthesis beginning an iteration set wa. 
unbalanced. For example: 


create >udd>Serpent>PJApple>(output1 output2 
command processor _-: Parentheses do not balance. 
r e@eee 


What was intended was "(output1 output2)" to create two segments. 
This error is handled by reentering a command line containing a 
balancing parenthesis. 


The problem may arise when iteration of a command is not intended. 
For instance, the "send message" command which transmits its arguments 
to another party. 


send message BDLucifer Serpent delete the files (in PJApple>dold 
command processor_: Parentheses do not balance. | 
r ees 8 @ 


Here the intent is to send a message containing a parenthetical 
thought. If the command line were reentered with a trailing 
parenthesis, two messages would be sent. That is, the user named 
would receive 

from PJApple.Serpent: delete the files in 


z=: delete the files PJAppledold 
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Notice that the first message contains the first string in the 
iteration set "(in PJApple>old)", and the second message, the second 
String. This problem may be avoided by enclosing the entire message 
in quotes. 


send_ message BDLucifer Serpent "delete the files (in PJApple>old)" 
r @e& @ @ 


It is advisable to always enclose messages in quotes to avoid 
unintentionally sending someone repeated messages. 


BRACKETS DO NOT BALANCE 


An invocation of an active function (a procedure returning a string to 
be inserted into the command line) is enclosed in square brackets. 
This error simply means that the command line had an unbalanced left 
or right bracket. 


list -pathname [pd | 
command processor : Brackets do not balance. 
r oese 


The correct command line would have contained "{pd]" to return the 
name of the user's. process directory. The error may be handled by 
entering a corrected command line. : 


In a manner similar to that described for the case of unbalanced 
parentheses, an unintentionally balanced active function invocation in 
a “send _ message" command line will transmit a message containing the 
value of the active function. The problem may be avoided by enclosing 
the message in quotes. 


QUOTES DO NOT BALANCE 


Quotation marks may be used in a command line to delimit ae single 
string argument that contains special characters such as "(", "J", or 
Space. The error means that the command line contained an unbalanced 
quote. The error may be remedied by reentering the corrected command 
line. 
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SECTION III 


COMMAND ERRORS 


These are errors detected in the processing of a command. They 
reflect not hardware conditions, but rather software conditions 
concerning, for example, the file system. Command errors are not 
restartable. A message is printed, and the system resumes what it was 
doing (e.g., listening for commands). The cause of the error may be 
fixed, and the command reissued. 


BAD SYNTAX IN PATHNAME 


This means that a pathname (the ordered list of entrynames identifying 
a segment in the storage system) has been formed incorrectly. The 
causes of this errce: are typing mistakes and an incomplete 
understanding of what a pathname is. (In the latter case, see the MPM 
Reference Guide, Section III, Constructing and Interpreting Names.) 


print >udd>Serpent>>PJApple>a.basic 
print: Bad syntax in pathname. >udd>Serpent>>PJApple>a.basic 
r eese ; 


print >udd>Serpent>PJApple>a.basic 


Here the user gave a pathname with two ">"s next to each other. As 
this is incorrect syntax, an error mesSage was printed. The user 
recovered by typing the correct pathname. This error will also occur 
if a"<" appears out of place in a relative pathname, that is, at any 
place other than the beginning of the pathname. For example: 


<<Student<Green>dold.runoff 


INCORRECT ACCESS ON ENTRY 


This means that the user, when logged in under the current project, 
does not have the correct access to a segment to perform a certain 
operation. This error can be dealt with by using the command 
"list_acl" (la) to determine why the user has no access, who can give 
him or her access, and if the user can do it him/herself, use the 
set_acl command to set the appropriate access to the segment. 


The error may arise when trying to read a segment or file. For 
example, when reading a segment with an editor (edm or qedx), when 
printing a file (using print or dprint), or when trying to compile a 
source program. In this case, the user does not have "read" access to 
the segment. For example, the following dialogue might occur for user 
Green logged in under the Serpent project. 


edm color.pli 
edm: Incorrect access on entry. >udd>Serpent>PJApple>color. basic 
r @ee#e 


‘list_acl color.pl1 

row BDLucifer.Serpent.* 
row * .SysDaemon.* 

r esses 


set_acl color.plir 
r eee 


edm color.pll 


Here the user has attempted to edit segment color.pli. The edm 
command detects that he does not have read access to the segment, and 
reports an error. By using the "list acl" command, he finds that only 
one other user on the Serpent project (BDLucifer. Serpent) has access 
to the file. The "set acl" command is used to give Green.Serpent 
access to the file, and he retries the command over again. The error 
may also occur’ when writing out a segment that is being edited. In 
this case, the user does not have "write" access to the segment. 


edm color.pl1 
Edit. 


W . 
edm: Incorrect access on entry. >udd>Serpent>PJApple>color.p]1 


E set_acl color.pli rw 
Edit. 


Yr eoeee 


La) 
t 
N 


Here the user tries to save a program that he has been editing, but 
cannot do so because he does not have write access to the segment. He 
is faced with the problem of setting the access on the segment without 
losing the editing that he had done. The edm "E" requests allows” him 
to execute a Multics command line, so this feature is used to let him 
invoke the set_acl command to recover from the error. After the 
access is changed, the edm write request may be reissued. If the user 
had been unable to change the access, he could at least save what was 
done by writing it out into another segment as shown below: 


E set acl color.pll rw 

set acl: Incorrect access to directory containing entry. 
Edit. : 

w colort.plt 

q 


INCORRECT ACCESS TO DIRECTORY CONTAINING ENTRY 


This error means that the user on his or her current project does not 
have enough access on the directory in which a segment is (to be) 
cataloged to perform some operation on it. Again, this error can be 
dealt with by using the list_acl and set_acl commands. 


This error most commonly occurs while trying to delete a segment (the 
user lacks modify access), while trying to set the access on a segment 
(lacks modify) while trying to move, create, or copy a segment (lacks 
modify and/or append), or while trying to find out information about 
the segment (lacks status permission). 


status <BDLucifer>souls.list 

status: Incorrect access to directory containing entry. 
>udd>Serpent>BDLucifer>souls.list . 

r ee @ @ 


list_acl >udd>Serpent>BDLucifer 


sma BDLucifer.*®.* 
sma *.SysDaemon.* 
r es 8 @ 


list_acl >udd>Serpent 


sma * .Serpent.* 
sma - * .SysDaemon.* 
r @eee 


set_acl <BDLucifer s 
r oee 


status <BDLucifer>souls.list 


Here the user attempts to find out information about the segment. The 
status command requires at least "s" access to the containing 
directory, and not having it, an error message is issued. The user 
then checks the fact, and looks at her access to the parent of the 
directory containing the segment to see if she can set the appropriate 
access herself. She then gives herself the necessary access, and 
reissues the command. 


SOME DIRECTORY IN PATH SPECIFIED DOES NOT EXIST 


This means that a directory specified in the pathname of a_ segment 
does not actually exist. 


The way to determine what directory is missing and/or the entryname of 
the directory actually intended is to use the list command. 


print >udd>Serpent>PApple>color.pl1 

print: Some directory in path specified does not exist. 
>udd>Ser pent>PApple>color.pl1 

r eees 


list -pn >udd>Serpent -dr 
Directories = 2. 


PJApple 
sma BDLucifer 


r ees 6 


print >udd>Serpent>PJApple>color.pll 


ENTRY NOT FOUND 


This means that a segment specifed was not found in the directory. 
(All the containing directories do exist.) 


This error may be dealt with by using the list command to see if the 
segment exists under some other entryname. The rename or addname 
commands can be used as desired to change the segment's entryname or 
give it an additional entryname. 


A common cause of this error in the case of novice users is misnaming 
the segment. For example, a Fortran source program must have. the 
suffix ".fortran". Thus if the segment "main" had been created 
containing the program, an error would ensue: 
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r *e¢ees 


fortran main 

Fortran 

fortran: Entry not found. main.fortran 
r @oeee 


rename main main.fortran 
r @e@06m6Usthl6m?t 


fortran main 


If the name identifies a link, then another possible cause of the 
error is that the segment pointed to by the link does not exist. This 
possibility can be checked by listing the link and checking whether 
the target exists. (Note that the link target may be another link, in 
which case the PEQcess must be PEReAved: ) 


INSUFFICIENT ACCESS TO RETURN ANY INFORMATION 


This error arises in the cases described for the above four errors 
when the user does not even have enough access to determine why the 
operation cannot be performed. The problem is that the user does. not 
have status permission on the directory containing a segment or, in 
the second case, to the directory containing the directory containing 
the segment. 


This error can be dealt with as described above by first setting 
access on the containing directory. Usually, a user who receives this 
error will not have access to set the required access, and will have 
to contact the user who controls the directory in question. 


ILLEGAL ENTRYNAME 


This message is generated by an editor when the user tries to write 
from an editor buffer into a segment with a malformed name. A 
malformed name is one which contains special characters such as blank, 
tab, "/", ete., or which contains missing components. Generally, this 
is a name which would make it difficult to access the segment because 
of system conventions. Examples of illegal names are: 


a*®b 
ho/whose/ 
c..d 


prog. 


This almost always occurs when the user has given an accidental 


write 
request. For example: \ 


edm second.fortran 

Edit. 

wes atb . 

edm: Illegal entryname. = a*b 


If it is desired to have a segment with a name containing such special 
characters, the segment can be written with a normal name, and renamed 
to the entryname containing special characters. 
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SECTION IV 


EXECUTION ERRORS 


This class of errors includes all hardware and software detected 
faults and conditions. When an error of this sort occurs, a condition 
is signalled. The condition may be handled by a_user-supplied 
condition handler (PL/I on unit), or if no on unit is found (as is 
normally the case), the system's on unit. The system's on unit prints 
an error message and invokes a new command level, suspending the 
execution of the program causing the error. This new command level is 
indicated by a ready message with a level number greater than one: 


r 1204 2.039 39.200 347 level 2,16 


After an error has occurred, and a new command level entered, the user 
should eventually do one of three things: 


1. Issue a release command to flush execution of the suspended 

program. For example, a quit signal (sent by striking the ATTN, 
BREAK, or QUIT key on the terminal) may be used to stop a run away 
program, or excessive printing. 


looper 
(quit) 
QUIT 
i eves LEVEL 35% 


release 
r *e@ee 


The release command need not be used immediately after the error 
occurs. If the cause of the error is not obvious, system supplied 
tools (e.g., probe) may be invoked at the new. command level to 
determine the cause. Whether or not this is possible, the release 
command should be issued before doing any additional work (e.g., 
changing and recompiling the program) to avoid more serious” and 
incomprehensible errors. 


The start command may be used to restart the program that was 
interrupted. This is possible if the problem is correctable, or in 
the case of an erroneous computation where the system's on unit 
performs some specified action to correct the condition upon 
restart. Such a correction might be to set the result of the 
computation, 2 ** -1000, to 0 after an underflow condition has 
occurred. The actions taken by the system on unit are often 
specified in the error message; if not, the user may consult the 
MPM Reference Guide if he or she desires. 


Another common practice is to "quit" out of a program that appears 
to be looping, check the CPU time that it has used by inspecting 
the ready message, and if it is looping, releasing the suspended 
program (after debugging the cause of the loop); otherwise, 
resuming the execution with "Start". (Note: quit/starting in this 
way may lose output directed to the terminal. However, under 
certain circumstances, this may be desirable.) 


count 
1 


(quit) 
QUIT 
Y esee Level -2,«. 


start 


7 


QUIT 
r .ee- level 3,. 


(quit) 


release -all 
r eeess 


Here a program named count has been invoked. It was then stopped 
by a quit signal and restarted by the start command; as ae result, 
a few lines of output were lost. The program was then stopped a 
second time by a quit signal and aborted by the release command. 
Notice how the level numbers are effected by this sequence. 


Issue the new proc command to get a new process. This will 
reinitialize all static variables, common blocks, I/O attachments, 
files, etc. The use of this command is recommended when 
inexplicable (1) errors occur. Once a new_proc is finished, it is 


(1) Errors for which you can see no apparent reason. . For example, you 


followed a memo verbatim; exactly the same thing worked before; an 
so forth. In general, a new proc should be tried if you have not seen- 
the error before and cannot find a ready explanation. 


ee, 


advisable (1) to retry the program with which there is a problem. 
Often the problem will disappear. If it doesn't, it is likely that 
a program bug exists, and you should continue to look for’ some 
other cause. The thing to remember is that an erroneous program 
can cause other programs including system programs to go awry. 


The error messages produced for most of this class of runtime errors 
are in a common format. For example: 


Error: Attempt to divide by zero at >udd>Serpent>PJApple> prog: 13 
system handler for error returns to command level 


The first line gives the type of error "Attempt to divide by zero" the 
pathname of the object segment causing the error (>udd>...>prog), the 
offset in the program object segment of the instruction at which the 
error occurred (13 octal), and, if the program were compiled with the 
"table" option, the source line number. The second line gives 
additional information about the error. Here it states that a new 
command level will be created. 


In general, an error which occurs in a system program can be traced to 
a user error. (2) In the case of an error in a system program, the 
user should verify that he has called it properly: that the correct 
number of arguments have been passed, that all documented requirements 
and restrictions have been met, and that all values passed as input to 
the system program have reasonable values. 


When an error occurs in a system program, the location in the user 
program where the system program was called is not given in the error 
message. This location can be determined using the probe command. 


(1) If the cost of program execution prior to occurrence of the error 
is acceptable. 


(2) This is not to say that there are not bugs in system programs, 
however it is more likely that the user did something wrong. 
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(line 


prog \ 


Error while processing in ring 0: 

Segment-fault error by bound _system_faults; 24330 
referencing 1777{0 

There was an attempt to use an invalid segment number. 
Entry into lower ring was by 

change wdir$get_wdir_i476 

(>system_ library standard>bound_fscom1_) 

referencing hes $fs_search_get_wdir 

ro... level 2,. 


probe 
Condition seg fault_error raised at get_wdir_; 16344. 
stack 
11 command _processor_ 
10 release stack 
9 unclaimed signal 
8 default_ error_ handler_ 
T real sdh 
6 get_wdir_ seg_fault_error 
5 prog 
y command _processor_ 
3 listen_ 
process overseer_ 
1 user_ init_ admin_ 
use prog 
source 


this -> wdir = get_wdir_ (); 
where source 
Current line is line 9 of prog. 


The error message may be interpreted as follows. The error was a 
segment fault error. The message "Error while processing in ring O" 
indicates that the error occurred in a_ supervisor program. The 
supervisor program was called from the user ring by the program 
change wdir$get_wdir_ (which is located in a bound segment in a system 
library). (1) The error message does not indicate what user program 
called these programs. This is determined by invoking probe, and 
issuing special requests to it. The stack request lists the procedure 
activations currently on the user stack (the called procedures). Here 


"get_wdir_" has been called by the user program "prog". The use 
request tells probe to examine "prog", and the source request’ then 
gives the text of the line at which the error occurs; "where" 


retrieves the line number of that line. Note that these (and most 
other) probe requests can only be used as shown when the program in 
question has been compiled with the -table option. 


The other information is largely irrelevant for the purposes of - 
casual user. 


4m 


RECORD QUOTA OVERFLOW 


This means that the disk storage quota for a directory has been 
exceeded. The problem can be dealt with only by finding or reclaiming 
additional disk quota. Usually, it is possible to have the storage 
quota on a directory increased by the project administrator. (1) 
Quota can also be temporarily reclaimed by deleting unneeded segments, 
or if possible moving a segment to a directory with unused quota. 


This error will occur when a segment is being written into. There are 
three common contexts in which this will occur. Writing out an editor 
buffer, compiling a program to produce an object segment, and 
outputting a file from a user program using language I/0 facilities. 
The following is an. example of a record quota overflow occurring while 
writing an editor buffer. This is a particularly dangerous problem 
for if it can not be corrected, the changes made to the text or source 
file will be lost. | 


edm prog.pll 
Edi 


Error while processing in ring 0: 
record quota overflow condition by bound file system; 3627 
referencing dDudd>Serpent>PJApple>prog.pl7! 30046 


Entry into lower ring was by 
>system_library_ standard>edm{5047 
referencing hes_ _$truncate seg 
r.... level 2,. 


get quota -wd 

quota = 2; used = 2 
Y° wees. Level 25. 
list 


Segments = 3, Lengths = 2. 


re 1 XXXxX 
row O prog.pli 
row 1 xxxx.plt 


r ..o. level 2,. 


(1) This is normally the person or group through which funding has 
been arranged. For most users, this will be the User Accounts Office. 
Students in courses should contact their instructor. Users on the 
Student project, should contact the SIPB. 
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delete xxxx 
r .ee.e level 2,. 


get quota -wd \ 
quota = 2; used = 1 
r .ee. level 2,. 


start 


q 
r ee#ee 


When the user tries to save his changes to the file “"prog.pli", the 
error occurs. The error message indicates that the error occurred in 
a supervisor routine called from the editor program. 


The get quota command gives the current value of the quota and _ the 
number of records currently charged against it. The list command 
gives the lengths (see below) of the files in the directory as well as 
their names. The user then deletes the object segment "xxxx" to make 
room to write the file in the editor. (Note that information is not 
being lost here, as the source file "xxxx.pl1" can be recompiled to 
create the object segment once sufficient quota has been obtained.) 
The get _quota command shows that a single record of storage has_ been 
freed up, and the start request causes the editor write operation to 
be restarted. Since he is finished editing, the user quits out of the 
editor. 


If the user then tried to compile the program, another record quota 
overflow would occur because with the file "prog.pli" successfully 
written, the number of records used is once again two. 


pl1l prog -table 
PL/I 


Error: record quota overflow condition by compile entryj621 
(>system_library standard>bound_cg_) | 
referencing >udd>Serpent>PJApple>progi0 


Y sees Level 2;. 


In this particular case, the user can do nothing to gain additional 
storage, except delete the source file xxxx.pli. If the file were of 
no use, the choice of deleting it would be acceptable; and the user 
could restart the compilation with the "start" command. If it were 
unacceptable, the user could only wait for additional storage. The 
problem would not be as critical as in the case above, as no 
information would be lost by logging out. 


The third context in which a record quota overflow might occur is in = 
user program that writes output to a file. 
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filewriter 


Error: record quota overflow condition by open_uns file$put_chars un 
(>system_ library standard>bound_vfile_) : 

referencing >udd>Serpent>PJApple>output filei0 

r .ee. level 2,. 


Note: The list command normally will give the "length" of the 
segments listed. This is the apparent size of the segment as computed 
from the bit count. However, bit count can be inconsistent with the 
number of records used by the segment if the segment contains zero 
page(s) (see above), or if the bit count has never been set (which can 
occur for a file which was never closed or a data structure or common 
block overlaid on a segment). Continuing with the example above: 


get quota -wd 
quota = 3; records = 3. 
r eee. 

list 


Segments = 2, Lengths = 4. 


re 3 test 
row 1 test.fortran 
; r e@eee##e 


The get quota command shows 3 records now in use (an additional record 
filled in by completing the compilation); but the list command shows 
lengths totaling four records. If the "-records" option is supplied 
to the list command, the actual records used by the segment will be 
given. : 


list -records 
Segments = 2, Records = 3. 


2 test 
1 test.fortran 


r e@eeae 


This is consistent with the results given by get_quota. The point is 
that when looking for segments to delete or move when reclaiming disk 
quota, the “"-records" option should be used to obtain the correct disk 
usage for the segment. In addition, It cannot be assumed that a file 
is empty because its length is zero. Rather, it is empty only when 
its records used is zero. 
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LINKAGE ERROR 


This error will occur when a program tries to reference an external 
symbol, for example, an external program or PL/I external data, and 
the specified symbol is not found. If the source of the error can be 
determined, and the problem fixed, the program can be restarted. Note 
that it is possible to "fix" a linkage error in such a way as to cause 
another flavor of the same error to occur’ when the program is 
restarted. A little thought will prevent this from happening however. 


There are four subclasses of linkage errors: 


Segment Not Found 


It means that a segment with the specified reference name was not 
found anywhere in the user's search rules. For example, assume that 
procedure "prog" calls another program, "zzzz$aaaa", which for some 
reason cannot be found. 


prog 


Error: Linkage error by >udd>Serpent>PJApple>prog;j20 (line 34) 
Referencing zz2zzjaaaa. 

Segment not found. 

Fo ween LeVel (2,4 


The basic approach for dealing with this error is to list the 
directories within which the program or data segment was thought to be 
in order to determine which of the following four cases apply. 


- the segment referenced really did not exist 


- the segment referenced exists, but its name was given 
incorrectly (e.g., misspelled). 


- an entry (segment or link) of the correct name exists within the 
search rules, but was ignored 


- the referenced segment exists in a directory not in the search 
rules. 


The typical user who is working alone, (i.e., not using programs in 
some "private" library) and is only using his own programs, standard 
system commands and subroutines will usually only have to consider the 
first two cases. Below is a further description of each case. 


a. The segment may not exist. For example, it may have never been 


created, A common problem for new users is forgetting to compile the 
program. Continuing with the above example: 
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list 


Segments = 3, Lengths = 3. 


re 1 prog 
row 1 2z2zzz.fortran 
row 1 prog.pli 


r «eae. evel 24. 


Notice that there are source and object segments for prog, but only a 
source segment for zzzz (zzzz.fortran). The cause of the problem 
then, is that there is no object segment named "zzzz" to. be found. 
Compiling the program (as shown below) will create such a segment; 
restarting execution will cause the search for the segment to be 
repeated, and this time found. | 


fortran 2222 
fortran 
YF eees level 2, 


list 
Segments = 4, Lengths = 4. 


1 2222 

re 1 prog 
1 2z2z2zz.fortran. 
1 prog.pli 


r eee level 2,. 


start 


b. No segment of the designated name may exist. This can happen if 
the user is confused about the name of the segment. For example, if 
a PL/I program is called "subr" (i.e., sSubr is the label on ‘the 
procedure statement) but the program resides in a segment of another 
name (e.g., subroutine), calling "subr" from another program will 
cause this error. This problem can be fixed by renaming (with the 
rename command) the segment (and the source segment) containing 
"subr", | 


rename subroutine.** subr.== 
r eeoee level 2% ; 


ec. If the search rules have been stated as the user desires,, and 
there is in fact a segment of the correct name in one of the 
directories in the search rules, then the most likely cause of the 
error is that the user has no access to the segment. For example, a 
"list" might show 
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list -pn >udd>Serpent>PJApple 


Segments = 3, Lengths = 4 


re 1 prog 
2 2222 
row 1 prog.pll 


r ....- level 2,. 


Notice that there is no access ("re", "rw", ete.) listed for the 
segment zzzz. This problem should be corrected with as described in 
Section IIIB (Incorrect Access On Entry, etc.). 


The second cause of this problem is a link of the correct name which 
points to a non existent segment or a segment to which the user has no 
access. A non-existent segment can be caused by the segment having 
been moved or deleted or the target pathname being incorrect. This 
might appear in a listing of the directory as follows: 


list -pn >udd>Serpent>PJApple 
Segs=0;Msfs=0;Dirs=0;Links=1. 


r.ee- level 2,. 

list -pn >udd>Serpent>PJApple -link 

Links = 1. 

ZZZZ >udd>Ser pent>BDLucifer>zzzz 
r ..e. level 2,. 


initiate >udd>Serpent>PJApple>zzzz 
initiate: Entry not found. zzzz 
Po wae JOVEGL 2:6 


The first list command (listing segments) shows that there are no 
segments in the directory, but that there is one link. The second 
list command shows the link to a segment in another directory. The 
initiate command is used to determine the reason why the segment 
pointed to by the link was ignored in the search. Here it does not 
exist. If the target pathname is incorrect in that a directory is 
named incorrectly, the command error "Some directory in path specified 
does not exist." would be reported. If the problem is no access, the 
error would be "Incorrect access on entry." 


d. While a segment of the correct name may be known to exist, the 
directory containing it is not in the search rules. The current 
search rules may be listed with the "print _search_rules" command. 


print _search_rules 
initiated segments 
referencing dir 


working dir 

>system_ library standard 
>system_ library_ unbundled 
>system_ library_ 1 

>system_ library_ tools 
>system_ library auth_maint 
r .... level 2,. 


list -pn >udd>Serpent>PJApple 


Note that this is a common problem to users of packages such as BMD, 
IMSL, SSP, or the M.I.T. Calcomp subroutines. These programs are kept 
in directories outside of the normal search rules. (1) 


In general, when it has been determined that a segment to be 
referenced is outside of the search rules, one of three things can be 
done. The search rules can be adjusted to include the directory 
containing the segment; the segment may be initiated; or a link to 
the segment can be created. For example, assume that the segment in 
question is the IMSL subroutine eigrf. The search rules can be 
corrected with the "add search rules" command. (2) The problem could 
be resolved by: 


add_ search rules >libraries>imsl -after >system_library_ unbundled 
r .... level 2,. 


print search rules 
initiated _segments 
referencing _ dir 

working _ dir 

>system_ library standard 
>system_ library_ unbundled 
>libraries>imsl _ 


r ..e. level 2,. 


Here, the print _search_rule command has been used to show the 
corrected search rules. This approach is useful when the missing 
segment is one of a collection of programs in the same _ directory 
(like a program library) whose other members are also likely to be 
used, 


(1) The documentation for such program libraries will usually specify 
how to make use of those routines. This advice should be followed. 


(2) In the example below, the new search rule is added after 
>system_library unbundled rather than after working dir to avoid 
searching >libraries>IMSL every time a command or subroutine is 
referenced for the first time in the process. 
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The segment may also be initiated. This is useful when there is only 
one program needed, and it is likely to be used only within the 
current process. 


initiate >libraries>imsl>eigrf 
r ...- level 2,. 


A link to the program may also be created. This need only be done 
once, and will enable the program to be referenced without issuing 
additional commands at any time in the future provided that the 
directory containing the link remains within the search rules. The 
Simplest way to ensure this is to place the link in the directory 
containing the calling program itself. . 1 4 

link >libraries>imsl>eigrf 

r «sae Level 25. 


where eigrf 
>libraries>IMSLo>eigrf 
r ..e. level 2,. 


The “where" command gives the pathname of the segment whose reference 
name is given. That is the segment that wiil be invoked if a program 
of the name given is called. It has been used here to verify that the 
link was successful. 


External Symbol Not Found 


This means that a segment matching the reference name specified was 
found, but that the (perhaps implicitly) specified entry point was 
not. 


prog 

Error: Linkage error by >udd>Serpent>PJApple>prog: 34 (line 38) 
referencing xxxx}|aaaa 

External symbol not found, 

YY saaa POVEl) 24.6 


This means that the segment xxxx was found, but the external entry 
point (symbol) “aaaa" was not found in the segment. In addition to 
trivial naming and typing mistakes, one of the more frequent causes 
for the error is that the program resides in a segment with a name 
different from the one used on the procedure statement of the program. 
The program is then called using the segment name. 


edm test.pli 
Segment not found. 
Input. 
tester: procedure (a); 
del a float binary(27); 
asa *® 2: 
end; — 


Edit. 
W 


q 
| ar 


pli test -table 
PL/I 
r oeee 


test 

Error: Linkage error by >udd>Serpent>PJApple>call testi54 (line 24) 
referencing testitest 

External symbol not found. 

P seas Level 2, 


This problem can be eliminated only by changing the name on the 
procedure statement from tester to test and recompiling the program. 


Linkage Section Not Found 


This means that a segment of the specified name was found, but that 
the segment did not have a linkage section (i.e., it is not an object 
segment). | | | 


prog 

Error: Linkage error by >udd>Serpent>PJApple>progi43 (line 42) 
referencing xxxx|aaaa 

Linkage section not found. 

EP veea-e BEVEL 32:5. 


This may occur if the name of a data or test segment was specified 
instead of the name of an actual compiled program. For example, a 
common problem is a source’ segment which is given the name of its 
object segment. 
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list 


Segments = 4, Lengths = 4. 


rw 1 xxxx 
XxXxXxX.pll 
re 1 prog 


rw 1- prog.pli 
r «eee level 2,. 


The list command shows the two names on the source file "xxxx.pli", 
When "xxxx" was referenced from the program, it was this segment that 
was found, but it was not a valid object segment. 


To recover from this particular error, the name must be deleted from 
the segment, and the text compiled into the object program to be 
called. The program can then be restarted. 


delete name xxxx 
i sew. LEVEL “Sy. 


pli xxxx 
PL/I 
r .... level 2,. 


start 


There is No Room to Make Requested Allocation 


This means that the size of a named external data area exceeded the 
system limit of 255K words. Examples of such areas are named common 
blocks in FORTRAN and external symbols given reference names (names 
containing a "$") in PL/I. For example 


nospace: procedure; 
declare bigarea$ (300000) external Fixed ‘binary; 
bigarea$ (1) = ... ; 


end; 
Executing the above program would produced the following error: 
nospace 


Error: Linkage error by >udd>Serpent>PJApple>nospacei11 (line 4 
referencing bigarea};. 

(with a create-if-not-found link) 

There is no room to make requested aiesarion: 

reese. level 2,. 


When such an error occurs in a PL/I program, the user’ should. examine 
the declaration of the external symbol and calculate the size. If it 
is a structure containing elements each smaller than the limit, the 
structure can be broken up. For example 

declare 

1 extstruc$ external, 

2a (100000) fixed bin, 
2 b (100000) float bin, 
2 ¢ (100000) float bin(63); 
would occupy a total of 400,000 words of storage. Member a uses one 
word per element; b, a single precision real value, usSes one word per 
element; and c, a double precision real value, uses two words per 
element. It can be broken up into two or three small structures: 


declare 


1 extstruci$ external, 

2 a (100000) fixed binary, 
1 extstruc2$ external, 

2 b (100000) float binary, 
1 extstruc3$ external, 

2c (100000) fixed binary; 


If the symbol being created is one large array, then the programmer 
should attempt to reduce the size of the array needed. If such a 
reduction is not possible, it may be possible to simulate the array as 
an array of pointers to cross sections of the original array. | 


declare 
array$ (3,100000) external fixed binary; 


would cause the error described here. This could be replaced by 


declare 
array (100000) fixed binary based, 
arrp (3) pointer initial 
(addr (array1$), addr (array2$), addr (array3$)), 
(array1$, array2$, array3$) (100000) external fixed binary; 


with the program edited to replace all references to 
array (x, y) by. arrp (x) -> array (y). 


Similar problems occur in FORTRAN when very large common blocks are 
used. As in PL/I, there are two cases: when there are many. small 
members of the common block, and when there is one very big member. 

In the first case, the problem can again be dealt with by splitting up 
the common block. 


common /data/ a(100000), b(100000), ¢(100000) 
becomes 


common /data1/ a(100000), b(100000) 
common /data2/ ec (100000) 


In the second case, that of one very large member, there is no method 
to get around the problem that is particularly efficient. The best 
that can be done is to write a function that references cross sections 
of the array defined in different common biocks. 


common array (3, 100000) 
becomes 
function array (x, y) 
common /datal/ array? (100000) 
common /data2/ array2 (100000) 
common /data3/ array3 (100000) 


go to (1, 2, 3) x 


1 return (array (y)) 
2 return (array2 (y)) 
3 return (array3 (y)) 
end 


SEGMENT FAULT 


This error means that the program has addressed a non-existent 
segment. What has happened is that an address value (pointer, entry, 
or label) contains an invalid segment number. There are two. general 
causes: using an uninitialized address datum, and using an address 
value designating a segment after that segment has been deleted. 


A deleted segment may be referenced under the following 
circumstances. If the program was, at the time of being deleted, 
still active (its execution suspended by a quit signal or error 
condition). 3 


prog 


Error: Attempt to divide by zero at >udd>Ser pent>PJApple>prog!2t 
(line 12). 

System handler for error returns to command level. 

r .ee- level 2,. 


delete prog 
r ates Level 24. 


release 


Error: Segment-fault error by unwind stack {120 
(>system_library 1>bound_sss_active_ ~ 

(while in pl1 operator ep_csa) 

referencing 367{i2 

There was an attempt to use an invalid segment number. 
r ..-. level 2,. 


Or if the segment is an input or output file that was not eiosdd prior 
to deleting the segment. 


prog 


QUIT 
r .... level 2,. 


(quit) 


delete output file 
r .eee level 


release 
r ee-@ 8 


prog 


Error: sipments fault error by open uns file$put_chars_ uns file; 1036 


(>system_library standard>bound vfile_)~ 

referencing 34510 

There was an attempt to use an invalid segment number, 
r ..e.. level 2,. 


An uninitialized address value is uSually caused by forgetting to 
initialize the corresponding variable. (1) 


prog 


Error: Segment-fault error by >udd>Ser pent >PJApple> prog; 327 
(line 43) referencing 2349{j27 


There was an attempt to use an dgveiid segment number. 
r .ee. level 2,. 


probe 
Condition segfault raised at line 43 of prog. 


(1) This can also cause any of the other bad address' problems 
described under other errors. An uninitialized pointer may cause a 
worthless value to be displayed for a variable qualified by the 
pointer or for the pointer itself. (Most uninitialized automatic 
pointers point into the stack). x 


source 


value p 
2349127 


In FORTRAN, address data problems may occur as well. One cause is 
passing an array argument to a FORTRAN subroutine whose corresponding 
parameter is not dimensioned. When the. program references’ this 
parameter with subscripts, FORTRAN treats the parameter as an entry 
value. For cxempnes executing a program of the following form 


subroutine mattran (arrin, arrout) 
dimension arrout(4,4) 


arrout (i,j) = arrin (j,i) 


end 
could cause an error of the form 


mattran test 

Error: Segment-fault error by >udd>Ser pent >PJApple>mattran| 143 
(line 12) referencing 3271756 

There has been an attempt to use an invalid segment number. 

r eese level 24 as 


probe 
Condition segfault raised at line 12 of mattran. 
source 
arrout (i,j) = arrin (j,i) 

value i; value j 

1 

1 
value arrin (i,j) 


Error: Segment-fault error by print_reference; 2373 
(>system_library standard>bound _probe_ 114517) 

referencing 3271756 

There has been an attempt to use an invalid segment number. 
r saete Level: 35.5 


pi 
symbol arrin 
entry variable parameter 


Here, the subroutine mattran has been called from mattran test. A 
segment fault error occurs on line 12, and probe is invoked to look 
for the cause of the problem. The “source" request gives the text o 
the statement in which the error occurred; "value" requests enable 
the user to determine with what variable the program is having 
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difficulty. The error reocecurs when the value of "arrin (i, j)" is 
displayed, indicating that "arrin" is the problem. The 
program interrupt (pi) command is used to probe, and the "symbol" 
requests used to display the attributes of the variable. The output 
shows that it is an entry variable and not an array at all. 3% 


Another cause would be passing too few arguments to a subroutine. In 
this case, referencing a parameter for which there is no corresponding 
argument may cause a segfault or other addressing error. 


NO EXECUTE PERMISSION 


This means that the user's process is attempting to execute a segment 

to which it does not have execute access. Upon getting this error, 

the user should attempt to set access (or have the access set for him 

by the owner of the segment) to read and execute, (1) and if. 
successful, restart the program. | 


prog 


Error: no execute permission condition by command processor_ 1522 
(>system_library_1>5bound_command —l0op_ ) 

referencing >udd>Serpent>PJApple> prog, 3 

r .ee. level 2,. 


set_acl prog re 
r .ee. level 2,. 


start 


This can occur if the access has been set incorrectly on the segment. 
For instance, if a "set_acl ** rw" command has been issued in the 
directory, or if the user had created the object segment before 
compiling by using the create command. 


The error can also occur when an uninitialized label or entry variable 
is referenced. This particular case can be distinguished from the 
others by the identity of the segment being referenced. If it is one 
which could be expected to be called (e.g., in the example above, 
"prog" is being called), then the problem is probably a simple access 
error; on the other. hand, if the segment , is a data or text segment, 
etc., then the problem is probably an uninitialized address datum. 


(1) At least "re" access is necessary for an object segment; ter 
alone will not suffice. Write access is not advisable. 
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NO READ/WRITE PERMISSION 


These mean that the process lacks the access required to read or 
write the segment mentioned in the error message. 


prog 


Error: no write permission condition by progi412 (line 101) 
referencing >udd>Serpent>PJApple>data_segi2 
r .... level 2,. 


The simplest cause is having failed to set or obtain the necessary 
access. As with a no_execute_ permission error above, the user may 
attempt to set the required access, and then peecart the program. 


‘This problem may also be caused by bad address data. This case may be 
distinguished from a simple access error as also given above. 


NOT IN READ/EXECUTE/WRITE/CALL BRACKET 


This means that an attempt has been made to reference an inner ring 
segment. The cause is almost always bad address data. 


prog3 


Error: not_in_ write bracket condition by progi26 (line 5) 
referencing dseg}0 


Yr «eee level 2,. 


The identity of the segment being referenced can often give a clue to 
the variable whose value is bad. A reference to dseg, as occurred 
here, usually indicates that a packed pointer (a pointer value 
declared unaligned) is uninitialized. A reference to the stack or 
linkage section, is strong evidence that an automatic or static, 
respectively, aligned pointer, label or entry value has not been 
assigned a value. 


FAULT TAG 1/FAULT TAG 3 


This means that an addressing modification fault has occurred while 
attempting to indirect through a pointer. Since these modifiers never 
appear in PL/I pointer cannes the problem is usually uninitialized 
address data. : 


prog 
Error: fault tag 1 by >udd>Serpent>PJApple>progi14 (line 8) 
referencing stack 4/3320 (in process dir) 


Ascii data where pointer expected. 
ro.ee. level 2,. 
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The fact that the program was referencing some data in stack_4 at the 
time of the error indicates that the bad pointer was an automatic 
value. If the program had been referencing "combined linkage section 
4.00, the bad pointer would be a static value. The address modifier 
may also be encountered when trying to execute data. In Such a case, 
the error message will indicate that the segment causing the error is 
a data segment such as the stack or the combined linkage section. 


The error fault_tag_1 is often caused by an uninitialized pointer 
occupying space previously filled with ASCII data (hence the second 
part of the error message). 


ILLEGAL MODIFIER 


This means that an illegal address modifier has been used. It may 
appear in a pointer value or in data being executed as regular 
instructions. 


prog 


Error: illegal modifier condition by >udd>Serpent>PJApple> prog! 44 
(Line 18) referencing stack 4/0 (in process dir) 

Possible illegal modifier in indirect chain or uninitialized pointer. 
Po cede Level: 2 os 


The causes of this error are identical to those of a fault _tag_ 1/3 
error. It is also not restartable. The problem must be corrected 
before the program can be run again. 


ATTEMPT TO REFERENCE THROUGH A NULL POINTER 


This means that a null pointer has_ been used as a locator value. 
qualifying a reference to a based variable. It usually indicates a 
logical bug in the program. 


prog 

Error: Attempt by >udd>Serpent>PJApple>progi57 (line 23) 

to reference through null pointer 

Po seee Lével 24% 
The programmer should carefully examine his or her program to 
determine how the locator (pointer or offset) value could have a null 
value at the location in which the error occurred. The variable may 
not be referenced with an explicit qualifier 

data instead of pl -> data 


In this case, the default qualifier e.g., based, (p) is used, and 
its value should be checked. | 
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probe 
Condition simfault 000001 raised at line 23 of prog. 
source . 
result = based num + 4; 
symbol based num | 
fixed binary(17) aligned based (p) 
Declared in prog. 
value p 
null 


This error may also occur for controlled as well as based data, if a 
controlled variable is referenced before it is allocated. 


SIMFAULT NNNNNN 


This means that the programmer has attempted to use a pointer with a 
segment number of -1 and an octal offset of NNNNNN. The cause is use 
of uninitialized address data. 


Note: a pointer with segment number -1 and offset 000001 is a null 
pointer. In such a case, the error message reads “Attempt to 
reference through a null pointer" as described above. The condition 
simfault 000001 is signalled explicitly only when the pointer value is 
not entirely a valid null pointer (for example, it has a non-zero bit 
offset). 


ILLEGAL MACHINE OPERATION 


This means that there has been an attempt to. execute an undefined 
machine instruction. 


prog 


Error: Illegal machine operation by prog;4 
Current instruction is: 

000004 000000000000 eer 0 

r «ccs Level 2,% 


The two most common causes of this error. are: branching to a 
nonexistent element of a constant label array, or using an 
uninitialized label oor entry value. The segment in which the error 
occurs may be used to distinguish the two cases. In the former, the 
segment will be one of those in use (in the example above prog); in 
the later, it will be a data segment (stack or linkage section) or 
some other unexpected segment. 


STORAGE CONDITION 


There are two causes of this error. First, the user has attempted to 
allocate more based or controlled storage than is available in the 
system area. This will be acompanied by the message that system 
storage is full. 


prog 


Error: storage condition by >udd>Serpent>PJApple>progi154 (line 52) 
System storage for based and controlled variables is full. 

system handler for error returns to command level 

r ...- level 2,. 


The programmer should inspect the declaration of the variable being 
allocated. The system cannot allocate more than 262,144 words of 
storage for any one variable. If the variable being allocated has. an 
expression for a string length or array bound, the value of those 
expressions should be checked. Often they may involve undefined 
values. If all allocations are relatively small (e.g., hundreds or 
low thousands of. words), the problem may be that the allocation is 
being repeated too many times. A check should be made for an infinite 
loop involving the allocation. 


Second, and most common, is that the stack has overflowed. This error 
will be accompanied by the message that the stack has been extended. 


prog 


Error: storage condition by >udd>Serpent>PJApple>prog;166 (line 58) 
Attempt to reference beyond end of stack. Stack has been extended. 
system handler for error returns to command level 

r «siee Level 2,.. 


This error will first occur when more than 64K words of stack space 
are required, or when a reference is made past the first 64K of stack. 
The stack is extended to the next 48K boundary. Depending on the 
cause for extending the stack, it may be permissible to restart the 
program with the start command. Subsequent storage conditions may 
occur if additional storage is required/referenced, and the stack will 
be extended in 48K increments up to a maximum length of 208K. Any 
attempt to use more than that will cause a fatal process error (see 
below). | 


One cause of this error is that the program is recursing too deeply 
(or infinitely). This case can be verified by examining the frame 
number, the second of the two numbers in the in ready message level 
information: 


r .ee- level .,137 


A value in the hundreds is a certain sign of trouble. (1) The 
cummulative automatic storage requirements for a moderately recursive | 
program (or set of programs) may also be too great. The required 
Storage can be determined from a compilation ‘listing produced with the 
"“map" option (under the heading "storage requirements for the 
program"). If the storage requirements will not exceed the maximum of 
208K, it is safe to restart the program. | 


An excessively large stack frame size may also arise if there are 
automatic variables declared with expression length or array bounds, 
and the expressions reference uninitialized values. A common mistake 
is to make use of another automatic variable in such an_ expression 
whether or not that variable has an initial value specified. For 
example, a program containing the declaration © 


declare . 
array (array dim) fixed binary, 
array dim fixed binary automatic; 


could cause the error message appearing above. A debugging session 
might continue as follows: 


probe 

Condition storage raised at line 58 of prog. 
source ; 

call subr (...); 


Here probe has been used to determine where the error occurred. The 
source request shows that the error occurred while trying to call 
another subroutine. The reason that the error occurs at this point is 
that until the subroutine is called (creating a new frame for the 
subroutine) the stack is not actually extended. So the programmer 
examines the program for abnormally sized variables: 


symbol array 


fixed binary(17,0) sPiened automatic dimension(71902) 
Declared in prog. 


The symbol request gives the evaluated dimensions for the array, 
showing it to be extremely large. (The error could appear in the same 
fashion if the large bounds were intended.) 


Another cause is subscripting an automatic array with a value far out - 
of bounds. This can be detected in PL/I programs by putting a 
subscriptrange prefix on the procedure statement. 


(subscriptrange): 
prog: procedure; 


ELT I TT TINT RSIS ESCs a OTST ILO SSO SG SSCS GE A SSS SE SS SONALI ICS 


(1) In fact, a value in excess of 30 


to 4O is uncommon, and can~ 
generally be regarded as a sign of p le 


y.24 


end; 


In Fortran this can be accomplished by compiling the program with the 
“csubscriptrange" control argument. 


fortran zzzz -table -subscriptrange 


A similar cause is .a_ string range error; that is, the use of the 
substr builtin function with out-of-range arguments. In general, this 
is an initial position (the second argument) which is negative or far 
past the end of the string, or a length (the third or assumed 
argument) that is negative or far greater that the actual length of 
the rest of the string. This error can be trapped by recompiling the 
program with a "stringrange" prefix on the procedure statement. 


A final cause is the invocation of a function that returns a value 
with star (expression) extents. If the bounds of an array developed 
as the return argument are bad, or if a bad substr expression or 
uninitialized character varying string is returned, a storage 
condition can be raised after the called function has returned, but 
before the calling program has resumed execution. This is indicated 
by a storage condition occurring in a system segment. If this is the 
case, there will be no other information as to what user program was 
executing at the time of the error. 


OUT OF BOUNDS FAULT 


This means that a non-existent portion of a segment has. been 
referenced by the program. A storage condition due to a stack 
overflow is really an out of bounds fault on the stack; as a result, 
the causes and recovery methods are similar. The most common causes 
include an out-of-range array subscript or substring reference... The 
error is particularly common when the data in question is a normal 
Fortran variable, commoned (occurring in a segment in the process 
directory), or uneommoned (occurring in the linkage section), or a 
PL/I internal static variable (occurring in’ the linkage section), or 
an external static variable (occurring in a segment in the process 
directory). If the segment is the program itself, it is likely that 
the program is referencing outside of the bounds of a label array or 
an internal static array that has an initial value specified but has 
never been modified. : 
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ILLEGAL PROCEDURE ae 


This occurs when the hardware is requested to perform an illegal 
operation. The most usual cause is uninitialized decimal data. 


baddec 


Error: illegal_procedure condition by >udd>Serpent>PJApple>baddec 
(line 5) referencing stack 4{ 3320 (in process dir) 


{ «ee Level 2, 


probe 
Condition illegal procedure raised at line 5 of baddec. 
source 
dv = dv + 1; 
symbol dv 
fixed decimal(7,0) aligned automatic 
Declared in baddec. 
value dv 


Error: illegal procedure condition by arithmetic to_ascii_:112 
(>system_library standard>bound trace ) 
referencing pl1_operators {10 


r .... level 3,. 


release -all 
r e@6¢ 6 6 


Here probe has been used to show the source of the line at which the 
error occurred. It contains a reference to a decimal variable. This 
is sufficient evidence to believe that the problem is uninitialized 
decimal data. Displaying the value of the variable will cause the 
same error again, confirming the diagnosis of the problem. (The 
release command, with the -all option, is used to flush execution of 
probe, suspended by the second occurrence of the error, and _  baddec, 
suspended by the first.) 


Other, less likely, causes of the same error are: transfering to an 
element of a label array outside of the bounds of the label array, and 
referencing uninitialized label or entry variables. In the former 
case, the location of the error will often be listed as the first line 
of the program; the line from which the condition is signalled will 
not be available. In the latter case, the location of the error will 
usually be in some unexpected segment. 
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CONVERSION 


This means that an error has occurred in the conversion of a character 
string to some other data type. This condition will occur in 
conversion to an arithmetic value if the string is not 4 correctly 
formed number. It will occur in conversion to a bit string if the 
source character string contains characters other that "1" or "0", 


badconv 


Error: conversion condition by >udd>Serpent>PJApple>badconvi22 
(line 6 onsource = "one", onchar = "o" 

Illegal character follows a numeric field. 

system handler for error returns to command level 

r.... level 2,. 


The error message gives, in addition to the location at which the 
error occurred, the values of the PL/I builtin functions, onsource and 
onchar. Onsource represents the character string being converted; 
onchar is the (first) character in the string which is invalid for the 
conversion. : 


This error may arise during implicit or explicit conversions among 
variables (or the results of expressions) in the program, or during 
execution of a get statement when the input is converted to. an 
arithmetic or bit value. — 


SIZE 


This condition has three causes. It will occur when the value 
assigned to a fixed point datum exceeds the precision of the target -- 
for example, assigning the value 9999 to a fixed binary(3) datum. The 
error will occur in this way only only if size checking was enabled 
for the statement in which the assignment was performed by a size 
prefix on the statement or the procedure statement. Second, it will 
occur during picture controlled conversion, if the target field is too 
small to hold the value being converted. Again size checking must be 
enabled. Third, it will occur during a put list or put data 
Statement, when the value stored exceeds the precision declared for 
the variable, or during a put edit statement, if the output field 
cannot hold the value being output. Size checking is always enabled 
for put statements. = 


size_err 


Error: size condition by >udd>Serpent>PJApple>size erri136 (line 14) 
Precision of target is insufficient for number of integral 

digits assigned to it. 

System handler for error returns “ command level 

r .ee. level 2,. 
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The user should be aware of a side effect of a size 
while executing a put statement. 
include an error on unit within 
variables: 


the program 


on error begin; 
put data; 
end; 


-If a size condition occurred, invoking 
statement within the on unit will cause another size 
Signalled when formating the variable for which 
originally signalled. The on unit will be invoked a 
the size condition signalled yet another’ time, 
infinitum, eventually leading to a storage condition 
error. 


ERROR CONDITION 


An 
the program, and there is no specific condition 
example, this includes’ use 
arguments that are out of range. 


for 


The following program is used to illustrate a 


the on unit, 


typical 


condition raised 


A common debugging technique is to 
that 


dumps all the 


the put data 
condition to be 
the condition was 
second time, and 
and so on, ad 
or fatal process 


error condition will be reported when an erroneous state arises in 


that state. For 


of mathematical builtin functions with 


Situation in 
which the error condition will be raised. 
bigexp: procedure; 
del sysprint file; 
put list (exp (2345)); put skip; 
end; 
Executing the program will cause the condition to be signaled. The 


system on unit gives the reason for the specific cause of the problem, 
and states a fixup to be taken if the program is restarted. 


bigexp 


Error: 
exp(x), x > 88.028, not allowed 

Type mstartn to set result = 

r .ee. level 2,. 


-17014118e+39 


start 
1.701e+038 
r eoee88 


After receiving the error, the programmer may decide 


fixup is acceptable, and restart the program as has been shown 


Notice that the program proceeds normally to paar EUs 
by the action of the system on unit. 


error condition by >udd>Serpent>PJApple>bigexpi53 (line 


that the standard 
above. 


the result as set. 


SUBSCRIPTRANGE 


This means that a subscript specified in an array reference is outside 
of the bounds of the array. The condition is normally raised only 
when the: programmer has’ specified that subscript range checking be 
performed (by placing a subscriptrange condition prefix on a PL/I 
procedure statement, or compiling a Fortran program with the 
-~subscriptrange control argument). Such checking is useful when there 
are unexplainable storage, out of bounds, or fatal process errors. 


_ subrange 


Frror: subscriptrange condition by >udd>Serpent>PJApple>subrange! 17 
(line 7). 

A subscript value has exceeded array bounds. 

system handler for error returns to command level 

r .... level 2,. 


robe . 
condition subscriptrange raised at line 7 of subrange. 
source 
array (i) = i; 
value i 


5 
symbol array 
fixed binary(17,0) aligned automatic dimension(8) 
Declared in subrange. 


Above is an example of a subscriptrange condition. Upon receiving the 
error, the programmer enters probe to determine the cause of the 
problem. The source request gives the text of the line on which the 
error occurred (line 7). He then displays the value of i and compares 
it with the dimensions for the array as given by the symbol request. 
Here the subscript, i, is only a little bit out of range. This 
indicates a logical bug, specifically, that the program is not 
constraining the value of the subscript properly. Alternatively, if 
the value of the subscript were grossly out of range (for example, 
-72301292), this would be an indication that the problem was that the 
subscript was uninitialized or assigned the value of some (function of 
an) uninitialized variable. 


This condition may also arise when a function which return a 
dimension (*) array is used, and the bounds of the array returned do 
not match the bounds of the array to which it is assigned. For 
example, assume that data has dimension (4) and that array fun returns 


an array with dimension (5). Then 
data = array fun (...); 


will cause a subscriptrange condition to be signalled. 


STRINGRANGE 


This means that a substring of a character or bit string value as 
specified by the substr builtin function is not completely contained 
within the string value. Given the reference 


substr (s, i, j)- 


the error implies that one of two conditions is true: that i, 
specifying the starting position of the substring, is less than one or 
greater than the current length of the string, or that j, specifying 
the length of the substring, is less than zero or greater than the 
number of positions included in that portion of the string from 


position i to the end. 


The stringrange condition will only be raised if the programmer has 
compiled the program with a stringrange condition prefix on the 
procedure statement or on the statement which uses the substr built-in 
function. 


stringrange 


Error: stringrange condition by >dudd>Serpent>PJaAppie>stringrange 
(line 7). A substring specified by substr is not completely 
eontained in the first argument. System handler for condition 
returns to command level. 

P< 6a: TEVEl 24: es 


\ 


probe 
Condition stringrange raised at line 7 of stringrange. 
source | 
substr (str, 1, i) = "a"; 
value i 
-1 
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FIXEDOVERFLOW, OVERFLOW, UNDERFLOW 


These errors indicate that the result of a computation has exceeded 
the precision of the machine. Fixedoverflow applies to fixed point 
computations and indicates that the result is too large. It should 
not be restarted. | 


folf 
Fixed point overflow by >udd>Serpent>PJApple>folfj143 (line 27) 


System handler for error returns to command level 
r ..e. level 2,. 


Overflow applies to floating point computations, and indicates’ that 
the result is too large. It should not be restarted. 


olf. 
Error: Exponent overflow by >udd>Serpent>PJApple>olf{160 (line 33) 


System handler for condition returns to command level 
r wees level 2,. 


Underflow applys to floating point computations, and indicates that 
the result is too small. The program is automatically restarted with 
the result of the COnDUNaeI On set to 0. 

unfl 


Error: Exponent underflow by >udd>Serpent>PJApple>unf1l{167 (line 39) 
| aa ere ; 


Notice that after an underflow condition the system does not enter a 


new command level, but instead continues with the program. Here it 
has terminated normally, returning to command level 1. 
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PROGRAM INTERRUPT 


The program_interrupt command is used to reenter a command subsystem 
such as edm or probe after an error condition or quit signal. The 
command signals the program _interrupt condition which is trapped by 
the subsystem. If the user mistakenly issues a program interrupt 
command to reenter a subsystem that does not handle the condition, or 
when there is no subsystem active, the condition will be reported as 
an error at command level. 
4 4 


program interrupt 


Error: program interrupt condition by program_interrupt; a 
(>system_library standard>bound_command_env_) 


f «eee bevel 24% 


If there is no_ subsystem active, the user should issue a release 
command to flush the program interrupt condition. If the user is 
trying to reenter a substem that does not handle program_ interrupt, he 
should issue a release command to flush the program_ interrupt and then 
a start command to reenter the _ subsystem. (Normally, however, a 
subsystem may be reentered by a start command oniy if it was suspended 
by a quit signal.) 
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SECTION V 


FATAL PROCESS ERRORS 


In general, a fatal process error occurs when the system detects a 
condition such that the process is not able to continue running. (In 
particular, the system default on unit cannot be executed to interpret 
the cause of the error.) The action taken in this case is to 
terminate the process in which the error occurred and to create a new 
process for the user. Because it is a new process, there is no 
information available about the programs that were running when the 
error occurred, the value of program variables, etc. The only clue as 
to the cause of the error is the error message. 


The single most common form of a fatal process error is an out of 
bounds error on the stack. The causes are the same as for a storage 
condition (see above) arising on the. stack. The message that is 
generated by the system designates that a fatal error has occurred, 
and then gives a error message indicating a more specific problem. 


Fatal error. Process has terminated. Out of bounds fault on user's 
Stack. New process created. 


In the event of this kind of fatal process error, it is advisable for 
the user to recompile his program with subscriptrange and stringrange 
checking enabled and try the program again. If a stringrange or 
subscriptrange condition then occurs instead of the fatal process 
error, then it is likely that new error is the source of the problems. 


If the fatal process error recurs despite the checks enabled, then the 
cause of the problem can be just about anything. It is recommended 
that the user check his access to all programs and files that he is 
using to insure proper access. He should also check for the possible 
causes of a segment fault error. Finally, calls to system. programs 
Should be checked to see if they conform to all documented 
conventions. Should these checks fail to turn up a clue. He should 
use the probe command to set breakpoints at various strategic points 
in his program to isolate the point at which the fatal process error 
is occurring. Often the process will have to be repeated with 
additional breaks set until the location is narrowed down to a single 
Statement. 


There are several other kinds of fatal process errors that the user 
may see. They include: 


No unclaimed signal handler specified for this process. 
This means that :no default on unit could be found. The 
possible causes include subscript and stringrange errors, and 
the use of uninitialized address data. (See above and the 
previous section.) : 


Fault in signaller by user's process. 
This indicates the presence of a very complex error condition 
and probably involves more than one cause. The user should 
apply the methods of described for the other errors and _ hope 
for the best. 


Unable to perform critical I/0. 

This means that the user's process was unable to perform an 
input or output operation at a crucial point. For example, 
writing out an error message. This indicates that the I/0 
attachments for the user_input, user_output, error_output and 
user i/o I/0 switches are in an untenable state. The user 
should consider the kinds of operations that he performed 
prior to the fatal error, and determine if they conformed to 
documentation. 


Process terminated because of system defined error condition. 
This is a catch all message. Again, the user should try the- 
methods described above. 


The reader should recall the comments about errors that vanish after a 


new process is created made in the introductory remarks to section 
IV. They apply to a fatal process error as well. 
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THE TYMNET NETWORK 


Assignment of TYMNET user id's and passwords contact: 


Lacy Johnson 
Honeywell LISD 
Multics Computer Center 
Box 6600 Mail Station K40 
Phoenix, AZ 85005 
Phone: (602) 249-7303 HVN 341-7303 


LUCAL LINES 


D>» a "help TYMNET lines" to obtain a list of TYMNET dial-up lines 
i1 the major cities serviced by TYMNET. —_ | 


CUST 


TYMNET charges $7.50 per connect hour which will be passed on to 
the appropriate cost center. 


THE TYMNET NETWORK 


e SUPPORTED TERMINAL 
) TYMNET supports a wide variety of terminal types. Each terminal 
type has an identifying character which must be sent to TYMNET 
when you first log in to establish the transmission 
characteristics of the terminal. 
IDENTIFIER TERMINAL REMARKS 


Baud 
rate 


Speed 
cps 


Type 


TermiNet-300 
TTY-37 


j é 
Hazeltine 


Execuport 


TTY 33/735 
TermiNet-300 


TermiNet-300 
Execuport 
Texas Inst. 
CSC 

Hazeltine CRT 


a 
(RECOMMENDED) 


Date] 
IBM 2741 


carrigae 
return 


Only 300 and 134.5 baud lines” are 


through the TYMNET network. 
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Full Duplex, 
odd parity 


Full Duplex 


For thermal printer 
terminals, a delay 
of N+6 or 7 
character times 

is used. 


Multics only accepts 
EBCDIC terminals 


1 through TYMNET. 


available on Multics for access 


FO1 
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THE TYMNET NETWORK 


LOGG:NG INTO TYMNET 


Turn on the terminal and coupler. 


If the terminal has adjustable data transmisSion speeds, set 
the terminal to 30 cps. This is to handle TYMNET's initial 
message. Lower settings give a garbled message during login. 


If you are using a terminal that has an Auto Linefeed switch 
(such as the TermiNet 300), turn it off during tne initial 
login procedure with TYMNET. Once you have made contact with 
Multics you may turn it back on. 


Dial the TYMNET phone number and wait for the high-pitched 
tone. (If the tone sounds weak or raspy, hang up and re-dial 
to obtain a better line). 


Place the telephone handset in the coupler or depress the 
"DATA" button if using a 103A or 113A dataset. 


The following message will be sent to your terminal at 10 
eps: PLEASE TYPE YOUR TERMINAL IDENTIFIER 


Set your terminal to the desired speed (if necessary), and 
type the appropriate letter or CR (carriage return). 


TYMNET will then send: -XXXX-YY-~- PLEASE LOG IN: where: 
XXXX is the remote access node number, and YY is the port on 
the node to which your terminal is connected. 


(OPTIONAL) You may check for the presence of the network 
supervisor (which controls the Tymsat you have ealled) by 
typing a single CR. If the supervisor is in control, the 
following prompt will appear: USER NAME: | 
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THE TYMNET NETWORK 


You may need the following control characters before entering 
your user name: 


a) control-H notifies TYMNET not to echo characters 


b) control-X to be used if you plan to input data from 
| : paper tape, cassette tape, or any other 
non-keyboard device. TYMNET must be able to 
Start and stop data entry.For this, 
control-Q starts the device and control-S 
Stops the device. 


¢) control-P. to be used if your terminal can only accept 
even parity. | 


After receiving "PLEASE LOG IN:" or “USER NAME:" enter your 
TYMNET user id (preceded by control characters if necessary). 
followed by a CR. (user id may be in upper OR lower case). 


TYMNET will then prompt you for your password: PASSWORD: 


Respond by typing your password(in upper or lower case), 
followed by a CR. NOTE: If you want to eliminate the prompt 
"PASSWORD:", enter your TYMNET user id, a semi-colon(;), and 
the password followed by a  CR.(THIS MAY NOT WORK FOR 
NON-ASCII TERMINALS) 


You should then receive either a semi-colon(;) or the 
following: Pnn (which indicates the port number of the 
TYCOM connected to Multics) HOST IS ONLINE 


From here on, the login procedure is exactly as if you were 
dialing directly into Multics. 


When you logout from Multics, TYMNET will respond: 


CP DISCONNECTS DROPPED BY HOST SYSTEM 
PLEASE LOGIN: (at this point you may hang up the phone) 


THE TYMNET NETWORK 


TYMNET PROBLEM RESPONSES 


ALL PORTS BUSY 


BUSY TONE 


. HOST DOWN 


ERROR ON PORTn 


To report trouble call the Multics Computer Center - 


All available Multics TYMNET ports are in use 


‘at the transmission speed you have requested. 


Try again later or try another transmission 
speed. 


If received when dialing the TYMNET network, 
wait a few minutes and try again. If the busy 


-tone persists, call the local telephone repair 


service to check if the local lines are truly 
busy or out of service. [If lines are continously 
busy, but not out of service, notify the Multics 
Computer Center. 


Indicates the Multics system is not in operation. 


Wait and try later or contact the Multics 


Computer Center. 


System is operationa: but a specific port 


or channel is not answering. Notify the Multics 


Computer Center. 


or HVN 341-7567 


(602)249-77 


ALABAMA ~ 
Birmingham 


ARIZONA 
Phoenix 


ARKANSAS 
Little Rock. 


CALIFORNIA 
Alhambra 
El Segundo 
Los Angles 
Los Angles 


Mountain View 
Mountain View 
Newport Beach 


Oakland 
Oxnard 

Palo Alito 
Riverside 
Sacramento 
San Clemente 
san Diego 


San Francisco 


San Jose 


Santa Bzrbara 


Santa Rosa 
Van Nuys 


COLORADO 


TYMNET 


205/942-4141 


602/249-9261 


213/572-0999 
213/640-1570 
213/629-1561 
213/683-0451 
415/961-7970 
415/941-8450 
714/540-9560 
415/465-7000 
805/487-0482 
415/326-7015 
714/825-9372 
916/441-6550 
714/498-3130 
714/291-8700 
415/391-9325 
408/984-5500 
805/966-3184 
707/526-2180 
213/986-9503 


Colorado Spr rness0a 7 le -9815 


Denver 


CONNECTICLT 
Bridgeport 
Danbury 
Darien 
Hartford 
New Haven 
Waterbury 


DELAWARE 
Wilmington 


303/458-7921 


203/579-7820 
203/792-3060 
203/655-8931 
203/568-2610 
203/787-5974 
203/757-2537 


302/058-5261 


DISTRICT OF COLUMBIA 


Washington 
Washington 


703/841-0200 
703/841-9560 


TELEPHONE NUMBERS 


FLORIDA 


Fort Lauderdale 305/467--7550 


Jacksonville 
Miami 
Orlando 
Pensacola 
Tampa 


st. Petesburg 


W.Palm Beach 


GEORGIA 
Atlanta 


HAWAII 
Honolulu 


TDAHO 
Boise 


ILLINOIS 
Chicago 
Chicago 
Freeport 


Freeport 
Rockford 


INDIANA 
Fort Wayne 
Indianapolis 
Marion 
Southbend 


TOWA 
Cedar Rapids 
Des Moines 
Iowa city 


KANSAS 


Toneka 

Wichita 
KENTUCKY 

Louisville 


LOUISIAVA 
Baton Rouge 
Lafayette 


G-6 


904/721-8100 
305/374-7120 
305/841-6850 
904/434-5514 
813/229-0981 
313/536-7823 
305/622-2871 


404/659-6670 
808/521-7481 
208/343 -4851 


312/346-4961 
312/368-4607 
815/232-2181 
(30 cps) 
815/233-2186 
(10 cps) 
815/398-6090 


219/424-5162 
317/257-3461 
317/662-0091 


219/259-9941 


319/364-3371 
515/280-9600 
319/351-4046 


913/233-1612 
316/265 -1241 


502/361-3881 


904/927--6400 
318/235-5202 


FO1 


New Orleans 


AARYLAND 
Annapolis 
Baltimore 


4ASSACHUSETTS 
Boston 
Boston 
Cambridge 


1ICHIGAN 
Ann Arbor 
Detroit 
Jackson 
Kalamazoo 
Southfield 
St. Joseph 


{INNESOTA 
Minneapolis 


ISSOURI 
Kansas City 
St. Louis 


EBRASKA 
Omaha 


EVADA 
Carson City 
Las Vegas 


EW HAMPSHIRE 
Nashua 


EW JERSEY 


TYMNET TELEPHONE NUMBERS 


504/586-1071 


~ 301/268-9290 


301/547-8100 


617/964-3925 
617/964-3900 
617/491-5476 


313/665-2627 


313/963-3388 
517/784-8522 
616/385-3150 
313/355-2950 
616/429-2568 


612/854-6659 


816/753--6620 


314/421-5110 


402/329-2970 


702/882-7810 
792/386-1899 


693/888-3354 


Englewood Clifts201/894-8250 


Moorestown 
Piscataway 
Princeton 
Wayne 
Union 


sW YORK 
Albany 
Buffalo 
Corning 


609/235-3761 
291/981-0370 
609/452-8228 
201/785-4480 
291/964-6300 


518/463-3111 
716/856-1400 
607/962-5071 


Huntington, 
New York City 
New York City 
New York City 
Niagra Falls 
Rochester 

Syracuse 

White Plains . 


NORTH CAROLINA 
' Charlotte 
Durhan 


OHIO 
Akron 


Cincinnati 
Cleveland 
Columbus 
Dayton 
Toledo 


OKLAHOMA 
Oklahoma City 
Tulsa 
Tulsa: 

Tulsa 


OREGON 
Portland 


PENNSYLVANIA 
Allentown 
Erie 
Erie 
Harrisburg 
Philadelphia 
Pittsburgh 
Valley Forge 
York 


RHODE ISLAND 
Providence 


SOUTH CAROLINA 
Greenville 


TENNESSEE 
Memphis 


L.1.516/673-5780 


212/350-9100 
212/551-9322 
212/344-7445 
716/285-9354 
716/546-1410 
315/437-7111 
914/761-8449 


704/376-0320 
919/549.-044 1 


216/535-1861 
(30 eps) 
513/242-7040 
216/781-7050 
614/421-7270 
513/223-3847 
419/243-3144 


405/947-0561 
918/492-5306 
918/492-1687 
918/663-2220 


503/224-0750 


215/433-6131 
814/725-8671 
814/454-6467 
717/236-1190 
215/561-6120 
472/765-1320 
215/666-9190 
717/846-4802 


401/351-2920 


803/271-2418 


—901/345-1111 
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TEXAS 
Austin 
Baytown 
Beaumont 
Dallas 
El Paso 
Ft. Worth 
Houston 
Houston 
Houston 
Longview 
Lubbock 
Midland 
Odessa 
San Antonic 


UTAH 


Salt Lake City 


VIRGINIA 
Norfolk 
Richmond 


WASHINGTON 
Seattle 


WISCONSIN 
Madison 
Milwaukee 
Oshkosh 


BELGIUM 
Brussels 


Contact E. 


233-3700 


CANADA 
Calgary 


Calgary 
Calgary 


Edmonton 
Montreal 


TYMNET TELEPHONE NUMBERS 


512/444-3280 
713/427-1123 
713/832-2589 
214/638-5800 
915/544-9590 
214/263-2341 
713/785-4420 
713/785-4411 
713/780-7390 
214/758-0801 
806/762-2402 
915/683-5645 
915/563-0273 
512/734-7381 


801/582-8972 


804/622-0435 
804/649-3050 


206/622-7930 


608/221-4211. 


474/257-3482 


414/235-4594 


Godhaird 


403/263-7301 
(30 eps) 
403/263-2006 

(14.8 cps) 
40 3/263--2072 
(10 eps) 
403/423-4888 
514/878-0584 


(30 cps) 
Montreal 515/878-0589 
(14.8 cps) 
Montreal 514/878-0588 
(10 cps) 
Ottawa 613/563-9841 
(30 cps) 
Toronto 416/863-6202 
Vancouver 604/688-9811 
(30 eps) 
Vancouver 604/688-4838 
(14.8 cps) 
Vancouver 604/688-4338 
(10 eps) 


ENGLAND 


Contact Allen Jenkins at 
901-606-4671 or 01-432-5573 
for further details to use 
the Data Base Service of the 
British Post Office. 


FRANCE 


PARIS 
Contact Mr. Feuvrier 
DTRI 


246 RUE DE BERCY 


PARIS CEDEX 12 75584 

(All France is "Toll Free" 
to TYMNET Nodes) 

346-12-55 EXT. 4331 

TELEX: 670372 


GERMANY 


FRANKFURT 
Contact Mr. Helmuth Wolf 
(611) .211.33.20 


HOLLAND 


AMSTEDAM 
Contact Mr. 
070-753652 


V. Moorsel 


MEXICO 


FO1 


TYMNET TELEPHONE NUMBERS 


MEXICO CITY 
Contact Mr.Rafael Rivera 
of CONACYT 
905/524-7365 


VETHERLANDS | 
The Hague 46-97-61 


2>UERTO RICO 
SAN JUAN 
Contact Mr. Ed Lukas 
724-3989 


SPAIN 
MADRID 
Contact Mr. Jaime Carvana 
248-8531 
WITZERLAND 
BERNE 
Contact Mr. Urs Loosli 
022-28-7117 
(All Switzerland is 
"Toll Free" to TYMNET Nodes 
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ABBREV EXAMPLES 


CRE "-ds CRF cabinet" 
:pwl - "cowl &1; twl &1; pwl &1; dl &1.wl" 
:wla_ad "tape ansi_ 1 -create -name sample -number 1 -format db 


-expires 12/31/99 ~density 800 -ring" 


‘Dirs (Ldirs ¥#]) 

Segs  (Lsezgs #*]) | 

GRT -ctl "p*a *a*a v7.3f r7.3f m°.3f b*d d*d $*.2f7/" -date 
-hour -min -vt -rt -mut -pgt -$t 

ecns ~dev uSer_i/o -dim syn 

FOREDW -ds "FOR Wallman" -he "AT PCO" 

FORDAK -ds "KAYDEN: CISL" -he "Cambridge MA" 

FORRRR -ds "STA-D DVP" -he "RON RIEDESEL" 

-dtm -dtcn -sort dtcm | 

~dtu -~dtu -sort dtu 

-~master -in 15. <a dtc300s -hyph 

bob Alvarado 

E [home_dir]>exl 

JUNK [pd]>junk_ 

ME [user name] 

-wd (wd ] 

—2acx ac x ([segs **. archive] ) 

am accept messages; mene, 20h 

DEFER am -hold ~call "do ""ec >udd>m>lls>ec>mess handler 
defer &f1"""; gr -set -call "print messages" 

no answer no -brief 

rest answer rest 

yes answer yes -brief 
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xpl1 


sale 


sysup 


ivt 
unmask 
athvn 
cl 


cispn 


ro 


mnth 


rtape 


wtape 


cpa 
U 
LSOLD 


return 


ABBREV EXAMPLES 


asr -exl>o -before >Osss 


asr >udd>Demo>dbm_ test>linus>executable -after 
working dir 


calc "(page fault _histogram;pfh.last pf time) - 
(disk traffic datai2,d)/6000000" 


cale "(te data!400+apte.virtual_cpu_time)/60000000" 
call hes $set_ips mask -o ~2 -r -o 0 

can be reached at 703-790-3213, hvn 231 

ef -a; rl -a 

check info segs ~pn >doc>iml info>**.info ~pn 
>doc>info>** .info -pn >udd>m>lib>info>**.info pn 


>exl>info>** info 


ro; am -pr -bf; rdy 


comp monthly -in 10 -of [month name].report'§ --pm 
[month name] -pass 2 

copy file ids [string tape ibm_ [response "tape 
name:"]  -nb [response "file number on tape:"] -bk 
[response "block length:"] --rec . [response "rec 


length:"] -fmt fb -mode [response "ascii or ebedic:"] 
-den [response "density:"] -no labels -retain all] -ods 
[string record stream  -target vfile_ [response 
"segment name:"]}] 


copy file -ods [string tape ibm_ [response "tape 
name:"] -nb [response "file number on tape:"] -bk 
[response "block length."] -rec [response "rec 
length:"] -fmt fb -ring -cr -mode [response "ascii or 
ebcdic:"] -den 1600 -no labels -retain all] -ids 
[string record stream_ ~target vfile_ [response 


"segment name:"] ] 
cpa -minlines 1 minchars 2 
cwd < 


cwd >udd>m>tac>s;in 1ls;tmr 1ls;dn ls ln lt3;an working ls 
ls ln lt 7 


ewd [value old dir]; pwd 


hee FO1 


~~ 


cwdd 
tapelist 
h 


/status 


:dd 
dm 


NUGAMES 


2 rim 


vip 
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ewd; cwd 

ewd;fo tape list;tapac tl cdt;ro;dp -dl tape list 
auacowa 

{string "USER ID " [user name] 


"TERMINAL NUMBER "suser 
[system n_users] USERS ON 


date time;ioa_ 
[user project]];ioa $nnl 
device channel;ioa_ [string 


~SYSTEMJ 
dd -force 


defer _ messages; memo -off 


_ &1;1lsd &1 -a 
p>master_ games 
p>new games 


df p>new games -bf;fo p>new games;do "ioa 
-sort" (Lcontents p>gamelist]);ro;cpa 
p>new games ;dl p>master gamesj;rn 


master games 


dl [pd]>stack 4 


dm3;a : =hold -cull do ""sms [lms] Messages Deferred." 
do "answer yes -bf move test>&l.runout saved==". 
do "comp &1.info -of &l.info -gljan 
&l.info.compout &1.info; dn &1.info.compout" 

"joa &1;cpa save>&l test>&1 5 1" ([segs 


do 
test>**]) 


do " answer no -bf cr &1.p; te &1.p; fo &1.p; profile 


&1; ro" 

do " rdn; gr -control Yes Master??°/"" -—set -call 
pm" 

do " set tty ~ttp vip7200 ~modes 
echoplex,1180,*ctl_ char,polite,replay,&fi". 

do "&1 ([segs &2])" 

do "&1 [directory &2]>([files &2]) &f3" 

do "&qfi" 

do "(cd cwd) [entry &1];cp -acl &1>** ==;cewd <;sbe 


[entry &1] &2" 
do ". call hes $make_ ptr -1;1 &1 &2 -r -1;1 -r -o O" 
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ped 


macabs1 


find 


sval 


valu 


i Sal 
listprog 


IPSstaff 


rut 


WEEKLY 


PLI 


COMP 


Pos pn 
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do ". call lib sort _ tree $by primary name -p &1 ~p = &2 
-p &3 -p &4" 


do ". create &1; if arg &2 -then ""addname a 


do ". dm;rf &fl;ioa “3/Done.;am -sShort -print" 


do ". if arg &1 -then "". ped «&«f1"" ~else "". ped mem 


cpu pagel 


do ". if argeq true [exists segment &1.absout] -then 


"Nttruncate &1l.absout""; ear &1 -rt -qg 1 -ag [spe &1] 


[suffix &1])" 
do ". in &1; Irn &1" 


do ". ioa "a: '"at changed to '“a'™' &71 [string 
[value &1]] &r2; value$set &1 &r2" 


do ". ioa_ [string [value &1]]" 
do ". ioa “a Cgpn ""&1"" &2QI" 


do ", list -nm -all -bf -Sorit: nm &1.**" 


do ". memo -al -time ""1245. &1" &2 [substr [day name 
&1] 1 3)]"" 1300: IPS Staff Meeting" 

do ". on cleanup im -brief ""dm; runoff &rf1; im; 
ioa $nn] """ 


do ".abfr rd do's ee 

do “.af ::comp &1i" 

do ".af ::pll &1" 

do ".1";ioa “i;ws >D>udd>m1lls “ls -all -sort dtu 
-mode -length -name -~dtem -dtu";do "10a... “13 pr 


>udd>m>lls>ec>&1" (Lsegs >udd>m>11s>ec>**] ) 


do ":2 [spe &1 pl1];LK &1 list pl1;UL &1 pll;pl1 &1. 
~map &f2;:3 [spe &1 pl1].list;SEVERITY pli &1" 


do ":4 {spe &1 compin}];LK &1 compout compin;comp &f1 
-~-of;:3 [spe &1 compin].compout" 


do ":l1f 4; ws &1 ""cis -pn [wd]>** -dt [default [value 
doc changes date] &2] &3 &4 &5 &6 &7 &8& agen 
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:doud 


zap 


ABS 


URAT 
MORE 
REPLY 


CPW 


pushname 


sm 

ckm 

no 
=pr_cal 
CD 


:cmpsr 
:empmsf 
CpLTL 


=cd 


typos 
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do ‘:par &1l;ear [home dir]>&1 -tm [response ""What 
time?""] -~ag do lwd] &fro2" 


do ">udd>mab>value$set dir [wd] -cm ""Set by the zap 
abbrev""; new proc" 


do "ABSUT1 &1 &r3;ear ME>&1 -rt -q [default "2" &4] -of 
pooldir>&1l.absout -bf -ag &1 &2 [fl "han g5 BR] 
&r3;lar -~position -q [default wat &4y yj" 
[>udd>m>rab>new>abs_ date] [wd] | 


do "© [sysn] / [sysm]" 


do "HEY ::sm &rfi" 


do "HEY [lms] &rfi" 


do "ac xf &1 [Epd]>[entry &2];if is [Epd]>Lentry &2] 
-then ""compare [pd]>Lentry &2] &2 &3 &43;dl [pd]>{Lentry 


(&2j 


do "add name &1 &!; delete name [directory &1]>([name 
&1 2]); ~*ename [directory &1]>[name &1 11] 6&2; 
add name ‘idirectory &1]>&2 [name &1]; delete name 
[directory &1]>&!" 

do "um -print;send message &f1" 

do "answer no mail Dudd>&2>&1>&1" 

do "answer no ~bf &f1" 

do "calendar &1/01 ~-fw holidays -irthdays" 

do "ed &1;SIS &1;SID &i" 


do "comp psr.[Substr &1 1 3] &f2 -pm ""&1, 1978"" 
[month name [response "Month No? (1-12)"]/1] 


do “compare &2>&1 &3>&1" (Lindex set 0 [response "Last 
comp no?"]]) ; 


do "cpa &1 <(old new)>==" 

do "create dir &1i;(sis sid) &1 (rew sma) [user 
name];(sis sid) &1 (re s) *;da &1 [user name].[user 
project]; sa &1 (sma s) ([user name].[user project] *)" 
d.> "create wordlist &1;trim wordlist &l.wl; 


print wordlist &1.wl" 
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yet, 


. cig, 
setre 
=dla 
REFRESH 


qxab 


comp 


:rfdtm 


filexist 


:dpnt 


dofa 


ADDTIME 
fout 
=dsre 
,, 10g 


CALENDAR 
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[time]] -then ""joa 


do "cwd;if [less [value Time] 
YES!!"™" -else ""ioa No.*x{value Time]"";cwd &1" (wd: 


do “"cwd;value$set Time [time 30 min];cwd &1" [wd] 
do "da &1 ..3sa &1 re *.*.%*; da &1 *.SysDaemon.*" 
do "dl &1.(absin absout)" 


do "dl [pd]>Lentry &1] -~bf;mv &1 
[pd] [entry &1] &1" 


[pd]>Lentry &1];mv 


do "dl  [pd]>abr -bf;fo [pd]>abr;if arg &2 -then ""do 


: mire oy Gory rn ao Leb &qi"";do aD ote tO ose a isizf 


[pd]>abr -then ""qxr [pd]>abr 1s/*/e.a/ s/"e.ab*¥/&&f/ 
tp i] : 


do "im; compose &f1; am" 


do "lm; memo -off;rf &1 -pm [string [year] [month name] 
[day; at [time]] &f2;im;memo -on" 


do "do ""if [exists segment &&1! -then -else mentioa | 
K& TM eri (Leontents &1jJ)" 


do ‘dp -ds "MAY, CABINET"" -he [string [default 
[upper_case [entry &1]] &r2]] -q [default 3 &3] -ned 
&f4 %1" 


do "°a &1 &2 ""push_wdir [if [ngreater [index [status 
-tp <1] directory] 0 J] -then &1 -else [directory &1]]; 
&3 & f4; pop wdir""" 


do "‘o &1.list;ioa %{73/;pli$times;ro" 


do "'o &1;io detach error output;io attach error output 
syn_ user_output" 


do "'o =cp>+src.&l.list;ds [=gtt>aft *src] -ch;ro;ioa_ 
"W+src.&1.List Created." 


do "fo >udd>m>ejw>{month name}.log time; ioa_$nnl 
[dat: time]; ro" 

do "fo CPS>calendar;calendar [date] -fw 
HDS>; >holidays;do ""calendar "8 "eet month ofy 


HDS>; >holidays"" ([index set 12]);ro;DPDL CPS>calendar 
&fi" 
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ec 


usage 


rl 
check 
fini 


ansrvxxx 


TALK 
ARDIND 


:indip 
deo 


reo 
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do “if [and [not [exists segment &1.ec]] [exists 


segment &1.absin]] -then ""an &1.absin &1.ec;exec_com 
&fi"" -else ""exec com éfi""m 


do “if [equal &n O] -then ""ps' usage: Usage is: 
usage"™" -else ""ps usage: Wrong number of arguments 
Supplied. For usage instructions, . type 
OEE Sag 6S UIEen tee ‘ : 


do "if [exists argument &1] -then ""release --al1"" 
-else ""release™"" 


do "if [greater [status &1.pl1 -dtem] [status &1 
-dtcm]] -then ""ps &1 has been modified""" 


do "if [have mail] -then ""mail &rfi"" -else ""do 
>udd>m>vv>basement>say; logout &rfi""" 


do ae i Lor [equal [format line “a 
[last_message sender]] [user name]] [equal [string 
[sutstr [last message] 1 10]] Acknowledg]] -then -else 
"sins Clast message sender] mun Ansvering 
service), grypmin. - ; 

do "am;sm &1 &23;dm" 

do "ind &1 -lm 3 -in 2 &f2" 


do "ind &1.inel; if [query Bad?] -then ""do UNH sp 
[pd]>&1 Snel. ingd imine 


do "io attach junk discard io open junk so;io detach 
error output;io attach error output syn_ junk;deomess" 


do "io :lose junk;io detach (junk error output);io 
attach error output syn_ user _i/o;reomess" 


do "io call attach &1 syn &2" 
do: “10g. WUNOT TED": do 2" Er. grferrt 


do "ioa ""I WILL BE AWAY “TIL &1 - LOG ME OUT IF YOu 
NEED THE TERMINAL" " 


do "iink (&f1) [home dir]>hh>==" 
do "list [where &1] &rf2" 

do "ls -nhe -first [default | &1)" 
do "mail >udd>&2>&1>&1 &f3" 
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“do "memo -alarm -repeat 12months -date ""éfF3"" &1 2's 


birthday!" 
co "pli &1 -table -symbols &f2;io0a Done." | 


Go "“pmotd; if [have mail] -then “"if [query MAIL?] 
-~then mM MMaL LMM. 1 ovout &1 &2' 


do "pr &1 1 9" 

do "print &1.runout 1 " 

do “px &1 -sm :ep>Lentry &l].px; dp -ds "MAY, 
CABINET"" ~he [string [default [upper case [entry 
&1)].px] &r2]] -q [default 3 &3] -ned -dl &f4 :cp>Lentry 
&1J.px" 

do "px &1!#* -sm :cp>Lentry &1].archive.px &f2" 


do "rn &1 $8tt5rn &2 &ljrn Yee! &2" 


do "set _tty ~ttp vip7200 -modes 
echoplex,1180,polite,replay,&fi" 


do "sm [nmf_last sender] &f1" 


downlog memo -al -tm [minus [system next_down_time] .1] 
-call LOGOUT// 


dp -dl 
dp -dl [segs **.list] 
general ready -control “a°/ -level; 


gr -string [substr [string [system installation id]] 1 
1] -date time -level -set -call pm;dm;memo -on;rdn 


help -pn >udd>Demo>dbmt>x>doc>(linus linus pre_release) 
io (close detach) | 


io (close detach) user output;io attach user output 
syn_ user_i/o 


io attach efo discard _;io detach error_output;io 
attech error output syn_ efo_ : 


ttach error output vfile_ 
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id 


:open 


mark 


=Uus 


down? 


lkel 


WAIT 
newu 
Dear 
mail? 
ti745 
tn300 
ROSY 


diablo 


whoa 
Vpi? 
liz? 


PUBLIC 


PRIVATE 


ABBREV EXAMPLES 


io call open file0(3 4.5 9); io call position fileO(3 4 
5 9) bof 


ioa_" 0 1 2 3 , y 
; 5 : 6 : T ; 8 ‘e 9 ; 
Oo" 

ioa "(users “a:*a) (units ‘*a:*a)" [system n users] 


[system max eugene a [system n cuntess [system max_ units] 


ioa_ "Schedu.ed shutdown: “a “a [system 
next down date] | system next down time] 


loa "*5/From:°-"a.°a°/To:~-Whom It May Concern’ /" 
[user name] [user project]; lke -time 60 -gr 3 -spw 
{value pass] 

lke -gr 5 -nol 

logout -hold — 

mail * 

mail ~brief 

stty -delay 0, 0, 0,0,0,0 

stty -modes tabs,11118,replay,polite;tab set 

stty -ttp rosy -modes “echoplex ,11130 


Stty -ttp tn300 -modes tabs,11130,vertsp -delay 
0,.18,0,0,0,59 


who -absentee 

who .VPI1 .VPI2 -VPI3 .VPI3 .VPI4 .VPI5 

who LMullen 

ws [hd] "sa ([segs *]) re *.*.%¥;sa (Lsegs *.*.**]) r 
*#.*.%3sa ({dirs **]) s *.*.*;sid [wd] s *.#.*;sis [wd] 


re -*, =e" 


ws [wd] "da ([segs **] [dirs **]) *.*.*;did ([dirs **]) 
*#.* .*#>dis ({dirs **]) *.¥,#" 
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WORKSHOP ONE 


Because these workslops build upon one-another, you’ should 
follow the instructiors precisely, using the names indicated. 


Throughout these workshops, the Person id "Student ??" is 


intended to mean your own Person id. 


Refer to the section "Access Sequence" in topic 2, and log in to 
Multics. 


Exercise the delete ‘character (#) and the delete line (@) 
symbols. For example, type the following how many _user commands: 
hmu 
hnu##mu 


jmu@hn j T###u TSmith 


Type the following commands and observe the results. Supply the 


answer "yes", "no", or "rest" when asked. 
help hmu 
help sked 
help help 
Enter the accept messages mode by typing "am". Note that the 


accept messages command created a mailbox for you. This mailbox 
is now a permanent part of your file space. You can now receive 
messages. 


List the names of all segments (files) that belong to you (ls). 
Note that your mailbox is the only segment you have. 
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Type the. following sequence of who commands and observe the 
results of each form. 


who 
who .FO1 
who .FQ1 -long 
who Student_04 
These are the names and projects of users who are currently 


‘logged in. Note your own "name". 


Select two or three FO1 users who are currently logged in and 
send them messages. For example, the following commands will 
send messages to Student_04 and Student 09: 


sm Student 04.F01 Does this really work? 


sm Student_09.F01 Great class, isn't it? 
Send yourself a message. 
sm Student _??.F01 From me to you! 


Enter the defer_messages mode (dm) and again send yourself a 
message. Note that you did not receive the message as you did 
before. The message is in your mailbox and will remain there 
until you print messages. Print the message(s) in your mailbox 
(pm). 


Again, send yourse..f a message. As before the message was placed 
in your mailbox because you are still in the defer messages mode. 
Return to the accept messages mode (am). You will now receive 


messages immediately, as they are sent. Note that the 
accept messages command did not' print messages currently in your 
mailbox. Print the message(s) in your mailbox. 
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Determine the current system configuration by typing. the 
following print_configuration deck commands: 
ped cpu mem 


ped 
Type the following sequence of commands: 


date 

date time. 
long date 
time 
minute 
hour 

day 

day name 
month 
month name 
year 


While available in this form, these commands’ will take on more 
significance when the topic of "Active Functions" is discussed. 


Generate your resource usage report for this billing period by 
typing the resource usage command (ru). 


Note: Your current login session may not be reflected, however, 
if other FO1 classes have been conducted this month, you 
may see considerable usage. 


Log out (logout) and return to the classroom. 
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log into Multics. Acce pt messages (am) and print messages (pm) 
if desired. List the names of all segments (files) that belong 
to you (ls). Note that you still have only one segment, your 
mailbox. 


Invoke the. qedx text editor (qx). Do not expect a ready message 
aS you are now in the qedx subsystem. | 


You are in the edit mode of qedx and have an empty buffer (a 
scratch~-pad). Enter the append mode (a) end type the following 
thre2 lines exactly as you see them: 


In anything att all, perfection es attained 
when there is no longer anything to take away. 
1,2p 


Return ‘to the edit mode (\f) and print the contents of your 
buffer (1,$p). 


Correct the intentional typing errors, as well aS any you may 
have made. For example, to change "es" in the first line to 
"is", type the sequence: 


1p (positions you to the first line and prints it) 
s/es/is/ (substitutes all "es" strings for "is") 
Po (prints the current line) 


To remove the last line, type the following: 


$p (positions you to the last line and prints it) 
“a (deletes the current line) 


After correcting all.of the errors, write the sontents of your 
buffer to a segment by the name of seg 1 (w seg_1). | 


Quit the editor (q) and note the ready messiuge. You are now back 
at command level. Your qedx buffer has been destroyed. (Don't 
confuse your qedx buffer with the permanent storage system 
segment seg 1) 


List the names of all segments that belorng to you (1s). Note 
that seg_1 was created for you by qedx's "w" request. 
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Invoke qedx. You again have an empty buffer. (Confirm this by 


printing the contents of your buffer.) Read the contents of 


seg 1 into your buffer (r seg 1) and again print the buffer's 
contents. 


Append the following text between the first and second line of 
your buffer by typing the following requests: 


Ip 
a 
not when there is no longer. anything to add, but 


Return to the edit mode—-- and print the contents of your 


buffer. Correct any typing errors. 


Write the contents of your buffer to seg 1 again. This write 
will replace the oli contents of seg 1 with the contents of your 
buffer. 


Print the contents of your buffer. Note that the, above write did 
not affect the bufier's contents. Write the contents of your 
buffer to seg 2 (just for fun). The contents of seg 1 and seg 2 
are now identical. 


WORKSI OP 2 CONTINUED ON NEXT 
PAGE 
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14. Type the following sequence of qedx requests in exactly the 
order as shown: 


1, $s/e/zzz¥/ 
/,$p 
~@ sm Student ??.F01 Can I do this within qedx? 
1,$s/2zzz// 
°1,$p 
W (To which segment did you write?) 
/is/ . 
Fis/ 
/is/ 
lis/ (Notice the wrap-around) 
1,$d 
1,$p (Why is your buffer empty?) 
r seg 1 
r seg 1 (Remember the default address here?) 
w seg 1 | 
r seg 2 
1,$p 
W (Why has gqedx forgotten the pathname?) 
5, $d 
Ir seg 1 (We're forcing the read address) 
1,$p _ 


15. Quit the editor. Note that qedx allowed you to quit even 
though you had not written out your modified buffer 
(Hsssssss!). ; | 


16. Print seg 1 (pr seg 1). It's contents should be: 


seg 1 


In anything at all, perfection is attained 
not when there is no longer anything to add, but 


In anything at all, perfection is attained 
not when there is no longer anything to add, but 
when there 1S no longer anything to take away. 


17. List the names of your segments and log out. 


_W-7 7 FO1 


WORKSHOP THREE 


Log in. Accept and print messages if desired. Execute the 
print _wdir command (pwd). This is your home directory and is 
currently your working directory. 


List the names of the segments in your working directory. 
Print. the contents of your seg 1 segment (pr seg 1). 


Create a segment by the name of Prince (cr Prince). List again 
the names of the segments in your working directory. Note that 
Prince has a length of zero records (i.e.: it is empty) 


List names of all entries in your working directory (ls -all). 
Note that you have no subordinate directories. 


Create a subordinate . directory by the name of Programs 
(ed Programs). List again the names of all entries in your 
working directory. 


Change your working directory to Programs (cwd Programs). Verify 
the change by printing your working directory. 


List the names of the segments in your working directory. Note, 
of course, that your Programs directory is empty. 


Without changing your working directory, print the contents of 
your seg 1 segment located in your home directory 
(pr >udd>FO1>Student ??>seg_1). What would (pr seg 1) have done? 
Try it. = 


Returt: to your home directory (cwd). Why is no pathname required 
for the cwd command in this case? Verify that you are back in 
your home directory. 


Change your working directory to Student 01's home directory 
(cwd >udd>FO11>Student 01) and verify this change by printing your 
working directory. What would the command "cwd Student 01" have 
done? If you're not sure, return to your home directory and try 
it, but remember tc change back to Student 01's home directory 
before continuing the workshop. = 
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List the names of the segments in your working directory. 
Understand that this is Student 01's home directory. You are 
able to list the names of his segments only because he has 
granted you access to do so. Note that you have read permissions 
on many of Student _01's segments. 


Print the contents of Student _01's treasure huit seyment and obey 
ull instructions specified. You are able to print the contents 
of this segment) only because Student 01 has grinted you access to 
do so. 


Change your working directory to the system's root directory 
(cwd >). Verify by printing your working d:rectory. List all 
directories under’ the root (ls ~-d). These are the system level 
directories. Note that they are primarily system libraries. 
Feel free to explore -- time permitting. 


Return to your home dir:ctory and execute the following commands: 


cr X : (create) 
ls X (list) 
dl X : (delete) 
ls X (list) 
dl >udd>FO1>Studen.. 01>treasure_ hunt (delete) 


Why were you unable to «ielet:2 Student 01's treasure hunt segment? 


ed X | (create dir) 
ls X (list) 


Recall that by default, the list command only deals with 
segments. | 


is X- =d ( 
dd X ( 


Add the names s_1, st and s1.compin to your’ seg 1 segment 
(an seg 1S 1 Si si.compin). List the contents of your working 
directory. Notice how the alternate names are listed. 
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Print the contents of seg 1 using one of the alternate names 
(pr si). Get the status of seg 1 using another alternate name 
Cst-.5. 1). Compose the contents of seg 1 one using the name 
sil.compin (comp s1.compin). Note the full-page formatting done 
by the compose command. 


Delete the segment seg 2 (dl seg 2). List the contents of your 
working directory. Notice the change in the segment count. 
Attempt to print seg 2. 


Delete the names seg _1, Ss_1, 81.compin (dn seg 1 S_1 s1.compin). 
List the contents of your working directory. Notice that the 
segment count is unchanged. 


Rename the segment s1 to seg 1 (rn s1 seg 1). List the segment 
seg 1 (ls seg _1) and observe the add names. 


Rename seg_1 to Prince (rn seg _1 Prince). Answer "yes" to delete 
the original Prince segment. (Recall that it is empty and is of 
no practical use to you.) 


Attempt to delete the name Prince (dn Prince). Since this is the 
only name on the segment, the command will inform you that 
deleting the only name on a Segment is not allowed. 


Copy the segment >udd>FO1>Student 01>alphabet into your working 
directory (Ceopy >udd>FO1>Student Ol>alphabet). List the contents 
of your working directory and print the contents of this copied 
segment. 


Why does your copy also have the name alphabet? What would the 


copy command look like if alphabet was to be copied and called 
my alphabet? 
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1. Log in. Accept and print messages if desired. Print your 
working directory. 


2 Change your working directory to >udd>FO01>Student 01. Execute 
the following commands: 


IS 1 alphabet 
S seg_1 alphabe 
AS * 


1s 3%, * 
AS s*.¥* 
ox: 
#,.# -exclude s*.* 
Sy Re¥urn to your home directory and execute the following sequence 
‘commands: (Note: If the printer queues are near empty, you 


a not be able to cancel some of your dprint requests) 
; 


ldr (list daemon requests) 

dp Prince _ (dprint) 

dp -q 4 Prince (dprint) | 

1dr. | (list daemon requests) 

ldr -all (list daemon requests) 

edr -q 4 Prince (cancel daemon request) 
ldr -all (list deamon requests) 

edr Prince - (cancel daemon request) 
ldr- | (list daemon requests) 


Note how some of these commands’ reported the total number of 
requests (system wide) as well as your total number, but only for 
the specified queue. 


re is an on-line printer accessible to you, dprint (for 
kK eps) the contents of your Prince segment (dp Prince). Do you 
reall what the default heading and destination banners will be? 
mber to pick up this output sometime before class tomorrow 


Enter the abbrev mode (ab) and type some command, such as pwd. 
Note that a profile segment was created for you. List the 
contents of your home directory and note this new segment. 
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Type a period (.). The reply is from the abbrev_ processor 
confirming the fact that you are in abbrev mode. Quit the abbrev 
mode (.4y) and again type a period the see what the commane 
processor will do with it. Re-enter the abbrev mode. 


Create an abbreviation for your User _id by typing a command line 


Similar to the following: 


-a ME Student _??.F01 


Check your abbreviation via the show request (.S ME). Recall the 
abbrev break characters and observe how they function by typing 
the following lines: 


Who is ME? 

Who is ME. 

Who is MEAN? 

Who is ME.the great? 
Who is ME_the great? 


ANAnAATN 


Use your abbreviation to send yourself a message. For example: 
sm ME Does this work? 
Define abbreviations for those users with whom you frequently 
communicate. For example: 
-a S9 Student _09.F01 
-a S4 Student 04.F01 


kiss. all of your abbreviations (.1). List one of your 
abbreviations (.1 ME). List all of your abbreviations that start 
with "S" (.la S). 


Enter the qedx text editor and write the following text to a 
segment by the name "start _up.ec". 


Start up.ec 


accept messages 


print messages 
abbrev 
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Quit the text editor and type the following command and observe 
the results: 


ec Start _up.ec 
If you received any error messages, invoke the gqedx editor, read 
the segment start_up.ec, correct your typing errors, rewrite your 
corrected copy, and try again. 
Remember: From now on this start_up.ec will be invoked for you 
(automatically) whenever you log in. 
Using qedx, create another segment named A.ec containing the 


following lines: 


A.ec 


ec Start_up.ec 


time 
ec Start _up.ec 


Quit the text editor and type the following command and observe 
the results: . 


ec A.ec 


Execute the print _motd command (pmotd). Note that a 
Person id.motd segment was created for you (in your home 
directory). It is through this segment that the system knows 
what messages you have already seen. 


Again, execute the print motd command. Since you have already 
seen the message of the day, the command will Suppress additional 
printings. 


Using the qedx text editor, add the print _motd command to your 
Start _up.ec. 
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Using the gqedx editor, input the following PL/1 source and write 
it to the segment "add.pli": 


add.plt 


add: proc; 
/* Written by Student ?? ¥*/ 


del (sysin, sysprint) file; 
del (I, Sum) fixed bin init (0); 


do while (I >= 0); 

put skip list ("value? "); 
get list (I); 

um = Sum +1; 


put skip list ("Sum is:", Sum); 
end; 

put skip list ("Fini"); 

put skip; ~ 

end add; 


Indent the PL/1 source (ind add.pl1). Correct any errors found 
by the indent command and try again. Print the PL/1 source and 
note the indentation that's been done for you. 


Compile add.pl1l (pl1 add.pl1). Correct any errors found by the 
pli command and try again. 


List the contents of your working directory. Note the segment 
add.pli (created by the text editor) and add (created by the PL/1 
compiler). add.pl1l is the source segment, and add is the object 
segment. 


Print the contents of the object segment add. This will take a 
few minutes as the "unprintable" binary code is. printed as an 
octal dump. Each \nnn represents three octal characters, which 
is 9 bits, which is one byte. 


Execute the PL/1 object program add which is in the object 
segment add (add -or- add$add). Supply positive integer values 
between O and 9999 when prompted and observe the results. 
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Hit the break key and note the level number in the ready message. 
You are back at the command level -- free to do. as you please. 
Execute some command such as pwd. 


Type the start command (sr). The program add has been re-startec 
at exactly the same point it was at when you hit the break key. 
In other words, the program add.is again waiting on you to suygply 
integer values. Key in a value and see if the Sum returned is 
consistent with the previous Sums. 


Key ina negative valywe to stop the program add. Add has 
terminated normally. Note the level number in your” ready 
message. (No level number denotes level one.) 


Again compile your add.pli source, but use the -table control 
argument (pl1 add.pl1 -table). This will allow you to 
symbolically "probe" the object program. 


Again execute your program add and supply several positive 
integers as before. Hit the break key. After receiving the 
ready message type the following command: 


probe 


You are now. inside the probe debugging subsystem. Note that 
probe printed a small status report about the current state of 
your process. Now type the following sequence of probe requests: 


stack 


This request traces your stack beginning with the most recent 
frame. Note the frame number of add's stack frame. Who called 
add, and who did add call? Probe's "current" stack frame is the | 
one in which the unexpected event occurred (i.e., frame 10 if 
you're in  abbrev mode). Any request that you issue wiil be 
relative to this stack frame. 


oo ed 


use add 


This request instructs probe to make add's frame (i.e., frame 7 


if you're in abbrev mode) your "current" stack frame. 
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where (Where are you, probe?) 

source (Print the "current" source line) 
value I (What's the value of I?) 

value Sum (What's the value of Sum?) 

let Sum = 500+Sum (Change the value of Sum) 

value Sum (What's the new value of Sum?) 
quit (Quit probe) 


You are back at command level. Note that your level number is 
unchanged. Type "start" and supply another positive integer for 
add. Does the new Sum reflect the change you made while in 
probe? Key in a negative value to stop the program add. 


Enter qedx and read the segment >udd>FOi>Student 01>long. 
Commence printing of the entire segment and then hit the break 


key. After receiving the ready message, type the start command 


and observe the results. 


While the printing continues, again hit the break key. After 
receiving the ready message, type the program interrupt command 
(pi). You are again in qedx, but at request level. Verify by 
typing 1,5p. Quit the editor. 


Print your current search rules (psr). These are the default 
search rules given to users at login. 


Note: The following exercise will work properly only if you have 
not executed the whe command during this login session. If you 
have executed the who command, type the command: "tmr who". 


Add the name who to your object segment add (an add who). 
Attempt to list the users currently logged in (who). Suffice it 
to say: Do not indiscriminately use command names for’ your 
program names. 


Remove this extra name from add (dn who), and check to see if who 


command works as uSual. If it doesn't work - why doesn't it? 
(For a hint, type: where who) 


Terminate (delete) the name who from your initiated segments (tmr 
who) and again attempt to execute the who command. 
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Change your search rules to include the directory 
>udd>FO1>Student 01>tools after your working directory (asr 
>udd>FO01>Student 01>tools -after working dir). Print your 
current search rules. a 


Note: The following exercise will work properly only if you have 
not executed the hmu command during this login session. If you 
have executed the hmu command, type the command: "tmr hmu". 


Attempt to list the number of users’ currently logged in (hmu). 
Suffice it to Say: Do not indiscriminately add unfamiliar 
directories to your search rules. 


Log out. When you next log in, you will again be given the 
normal default search rules. 


This page has intentionally 
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Log in and type the mail command. Recall that the mail command 
will extract messages and mail. Use this command if and when you 
receive notification that you have mail. 


If you have not received a message requesting partnership, choose 
an FO1 user who is currently logged in and send him/her a message 
similar to the following: 


sm Student 07.F01 May I be your partner? 


Send your partner messages inthe dialogue mode, as in the 
following example. Wait for a reply between lines. 


sm. Student _07.F01 

How are you doing today? 

That's good. I'm not doing too bad myself. . 
See you later. 


Mail your partner the contents of your add.pl1 segment. For 
example: . 


mail add.pl1 Student _07.F01 


List the ACL of your add.pl1 segment (la add.pl1). Note: This 
ACL was given automatically by the system when you created 
add.pli. 


When your partner requests access to your add.pli1 segment (and he 
will), do the following: give your partner read access, verify 
by listing the ACL of your add.pll segment, and send a reply to 
your partner. For example: | 


sa add.pl1l r Student_07.*.* 
la add.pll 
sm Student _07.F01 You now have access to add.pll. 
Attempt to print your partner's add.pl1l segment. For example: 
pr >udd>FO1>Student_07>add.p11. 


Request read iuccess to your partner's add.pl1l segment and attempt 
to print the segment again. (Keep trying until it works) 
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Note: Do not proceed until your partner has requested (and has 
been given) access to your add.pl1 segment. 


Remove your partner's name from your add.pl1 ACL. For example: 
da add.pl1 Student_07.*.* 
Verify the change by again listing the ACL for add.pl1 
List the ACL on your home directory (la). Who are these users? 
Attempt to set access for yourself on your home directory 
(sa -wd sma Student _??.*.*). Why can't you set access on your 
own home directory? 
Execute the following commands: 
ls -d 
la Programs 
copy alphabet Programs>A 
ls Programs>** 


Note your access on segment A. 


pr Programs>A 
da Programs Student_??.F01.* 


la Programs (What permissions are needed?) 
er Programs>B (What permissions are needed?) 
ls Programs> ** (What permissions are needed?) 
dl Programs>A (What permissions are needed?) 
pr Programs>A (What permissions are needed?) 


Note that you can do nothing except print the contents of the 
segment A. 


Type the following command sequence. (If necessary, include your 
time zone in the -time request. For example: -time "4pm est") 


memo 
memo Happiness is Multing the day away. | 
memo -time 4pm -alarm It's almost time to go home. 
memo -1ist oo 

memo 


Modify your start _up.ec to include the mail and memo commands. 
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14. Type the following command sequence. 


pat (print attach table) 

fo (file output output file) 
ae . = = 

ro : (revert output) 


pr output file 


Notice the difference in the I/O switch attachments. 


15. Before logging out, check your mailbox. 
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Send yourself the following messages: 


sm 
sm 
sm 
sm 
sm 
sm 
sm 
sm 
sm 


sm 


ME 
ME 
MI: 
ME 
ME 
ME 
ME 
ME 
ME 


ME 


Create the 


My working dir is [wd]. 

Last message sender was [lms] 

The time is [time]. 

The date is [date] which is the same as [long date]. 
[user name].[user project] login at [user login time]. 
Current user load is [system n_users]. 

Multics: [system installation id]. 

Multics: [system company]. | 

The absolute pathname is [path add]. 


My one-component segments are [segs *]. 


following abbreviation: 


.ab reply sm [last message sender] 


List all of your abbreviations. 


Execute the following command lines: 


-S reply Who are you? 
reply Who are you? 


Who in fact was the last_message sender? 
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Create two segments "Names A" and "Names B" containing the 
following lines: 


Names A Names B 
A10 B10 
A20 B20 
A30 B30 


Now execute the following command lines and observe the results: 
sm ME [contents Names A] 
create [contents Names_A] [contents Names_B] 
list A* B* 
list [contents Names A] 


dl [contents Names A] 


list A* B* 


Create an exec _com segment containing the following text: 


query.ec 


&command line off 

ewd [response "Working directory desired?"] 

&print Your working directory is: 

pwd 

sm ME [response "What would you like to say to yourself?"] 


a ee RE Ee ae a EE | 


The first line of the above exec_com will] inhibit the printing 
(echoing) of the command lines when the exec com is executed. 


Now invoke this exec_com and provide legitimate answers to the 
questions asked. Invoke the exec com again, but this time respond 
to the first question by simply hitting the line feed key. Do you 
understand why you are now back at your home directory? 
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Use qedx to create the following exec_com: 


recur.ec 


&command line off 

&print ENTRY: é&n arguments, first argument is &1 
&if [ngreater &n 0] &then &goto START 

&quit 


&label START 

&print Executing exec com command 

ec recur.ec &2 & &4 &5 &6 &7 &8 

&print EXIT: &n arguments, first argument is &1 
&quit 


Invoke the exec com and observe the results by typing: 
ec recur.ec ABCDEFGH 


Change your working directory to your Programs directory and 
again invoke this exec_com by typing: 


ec >udd>FO1>Student ??>recur.ec A BC 


Why does the exec com fail now? Can you correct the problem? 
Try to correct the problem. 


Return to your home directory and execute the following sequence 
of commands 


-ab pli_ex do "pr &1.pl1;pl1 &1.pl1; [entry &1]; logout" 
.a F1 >udd>FO01 

na 

pl1_ex Fi>Student_01>nothing 


The entry active function returns the entryname of the supplied 


pathname. Why was the entry active function used? Was it 
necessary? Why were you logged out? 
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Use command line iteration to send yourself several messages. 
For example, if you are Student 06 type the following line: 


sm Student 0(6 6 6 6).FO1 This is number (1 2 3 4)! 
Recall the contents of your segments Names A and Names B and 
execute the following command lines: ~ | ae 

sm ME [contents Names B] 

sm ME ([contents Names B]) 

list [contents Names B] 

rename ([contents Names B]) ([contents Names A]) 

list A* B* 

create ([contents Names A]).[date].[user name] 

list A*¥,#* 

rename A*,**® =.= 


list A®¥.#* 
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The print command only allows one pathname argument such as 
"print add.pli". Use command line iteration to print the 
segments Prince and alphabet as follows: 


print (Prince alphabet) 


Now execute the following command lines to create and test an 


abbreviation for tne print command that allows it to accept up to 
five pathnames as arguments. 


-ab :pr do "print (&1 &2 &3 &4 &5)" 
:pr Prince alphabet >udd>FO1>Student_01>nothing.p11 


What would happen if the abbrev had been defined as follows: 
-ab print do "print (&1 &2 &3 &4 &5)" 


Try it! When you get the error message, notice the level clause 
of your ready message. Go into probe and execute the "stack" 
request. Do you understand wny the stack overflowed? (You will 
probably want to "break" inorder to stop the output from the 
stack request.) Recursion is one reason why command names are 
normally not used for abbreviations. | 


Now generalize the print command abbreviation to accept star 
names and test it by typing the following command lines: 


.ab :pr do "print ([segs &1])" 


:pr s*,* 
:pr alphabet 


Modify your start _up.ec to include the three new lines as 
indicated below: 


Start _up.ec 


&command line off 


{previous contents} 


&print Start _up complete. 
&quit 


WORKSHOP EIGHT 


Execute your start_up.ec to verify its proper functioning. 
Execute the new _proc command and observe the results (this may 
take a minute or so). 


Create the following exec com and name it weird.ec. 


weird.ec 


‘&print Beginning &ec name exec com 
&if [nequal &n 2] &then &goto LOGOUT 


pli &1.pli1 
pr &1.pli1 
&quit 


&label LOGOUT 
&print Bye Bye 
- logout 
&quit | 


Execute your weird exec com using the following command lines 
(you will receive some error messages since sub.pl1 does not 
exist): : 


ec weird.ec add 
ec weird.ec sub 


Add the name weird.absin to your weird.ec segment (an weird.ec 
weird.absin). Verify by executing the following list commands: 


ls weird.ec 

ls weird.absin 
ls weird. ** 

ls wt, #* 

ls **,ec 
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c> 


spa 
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Submit an absentee request using your weird.absin segment as the 
absin segment. (ear weird.absin -ag add). Attempt to observe 
the absentee process by repeatedly typing: 


who Student_?? 
Hopefully you will notice yourself listed twice, for example: 


Student_08.FO1_ 
Student _08.F01* 


After the absentee job has completed, you will find a 
weird.absout segment in the same directory as the weird.absin 
segment. Print and observe its contents. In particular, note 
the login and logout times, and the fact that the absentee 
process used your start _up.ec (which is potentially undesirable). 


Start _up.ec 


&command line off 
abbrev 
&if [equal &2 absentee] &then &quit 


Submit again an absentee request for weird.absin. This time, 
however, schedule the absentee job for 8 am local time tomorrow 
morning (use your time zone if necessary) . For example: 


ear weird.absin -time "Friday 8am est" -ag add 


Execute your weird exec _com using two arguments. For example: 
ec weird.ec add mad 


Why were you logged out? 
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Log in to the system and see if your absentee request from 
yesterday ran as expected. 


Log out using the -hold control argument (logout ~hold). Log 
back in. | 


Type the following sequence of change wdir commands. Verify your 
working directory after each line via the print wdir command. 
cwd < 
cwd < 
cwd 
cwd << 
cwd 
ewd <Student_ 01 
cwd 


Type the following sequence of commands. (You will receive some 
error messages.) 


er A.ec B.ec C.ece (create) 
ls **.ec 3 (list) 
an **.ec ==.absin (add_name) 
ls **.ec (list) 
rn (A B C).ec (a b c).ec (rename) 
ls *#.ec | (list) 
er mx y" watt . (create) 
ls # (list) 
rn a.ec ;hmu | (rename) 
rn a.ec "shmu" (rename) 
ls # a (list) 
Type the following sequence of commands: (Note: You will 
receive some "Segment not found" error messages) 
wh pwd | (where) 
pwd | (print wdir) 
wh funny (where) 
funny (funny) 
in >udd>F01>Student_01>funny (initiate) 
wh funny | (where) 
funny (funny) 
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Type the following sequence of commands: (Note: You will 
receive some "Segment not found" error messages) 
ls.-1k (list) 
ls sad (list) 
sad | 7 (sad) 
1k >udd>F01>Student_01>sad (link) 
1s -1k (list) 
ls sad (list) 
wh sad (where) 
sad (sad) 
Type the following sequence of commands: 
copy Prince P1 (copy) 
list P* | (list) 
cpa Prince P1 (compare ascii) 
ac rd A.archive Prince P1 (archive) 
ac t A.archive (archive) 
list P* (list) 
ac x A.archive (archive) 
list P* (list) 
ss P1 (sort_seg) 
pr P1 (print) 


cpa Prince P1 


Type the following sequence of commands: 


wh list 
ls [wh list] 


(compare ascii) 


(where) 
(list) 


Note the permissions you have on the list command procedure (this 
is the object program). Note also (from the add names) that the 
list command procedure is "bound" (see the bind command) with 
other operating system command procedures. 


Type the following sequence of commands. (You will not receive 
any terminal output for the first four commands.) 


fo t_ file 
pwd 

ls -all 
who .FO1 
ro 

pwd 

pr t file 
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(file output) 
(print wdir) 
(list) 

(who) 

(revert output) 
(print wdir) 
(print) 


FO1 
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Type the following sequence of commands: 


Prince 
35 
Prince 


80 


pr 
1l 
pr 
ll 


Type the following sequence of commands: 
gr -string "Done Master!" ~set 

pwd 

time 

ru 

gr -revert 

date 


Turn off the ready message (ready off). 
prefer this mode because they can 
following sequence of commands 
ready message: ' 


&q 

gq < 

cwd 

ll 79 

an P1 P2 . 
>udd>F01>Student_01>reassure 
ready | 

dn Pe 

cr seg 3 


ready on 
ls seg 3 
logout 


interact faster. 
just to get the feel of having no 


(print) 

(line length) 
(print) | 
(line length) 


(general ready) 
(print _wdir) 
(time) 

(resource usage) 
(general ready) 
(date) 


Most experienced users 
Type the 


(get_ quota) 
(get quota) 
(change wdir) 
(line length) 
(add_name) 
(reassure) 
(ready) 
(delete name) 
(create) | 
(period) 
(ready on) 
(list) 
(logout) 
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Happiness is Mult'ing the day away! 


FO 1 


been left blank. 


701 
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